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PREFACE 



This document contains a comprehensive description of the PDP-11 Disk Operating System 
Monitor. The document is written for the PDP-1 1 programmer — it assumes familiarity with 
the contents of the PDP-ll Handbook 1971 and the MACRO-11 Assembler (see document 
number DEC-1 1 -OMACA-A-D), Previous experience with monitor or executive systems 
would be helpful . 

The document is separated into three chapters: Chapter 1 is an introduction to the DOS 
Monitor, and provides general information about the disk operating system. Chapter 2 
describes the keyboard commands available to the system operator through the Monitor; 
concepts and operation of each command are also explained. Chapter 3 describes the pro- 
grammed requests that are available to the programmer through the Monitor. This chapter 
also explains the concepts and operation of each programmed request. The entire document 
is summarized in the appendices. Appendices D (Monitor Commands) and E (Monitor 
Programmed Requests) should prove to be invaluable to the DOS user. 

In addition to the DOS Monitor, the PDP-11 Disk Operating System Software includes: 



FORTRAN IV 
MACRO-! 1 Assembler 

ODT-llR Debugging Program 
PIP, File Utility Package 
Link-ll Linker 
Libr-1 1 Librarian 
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SOFTWARE SUPPORT CATEGORIES 



Digital Equipment Corporation (DEC) makes available four categories of software. These 
categories reflect the types of support a customer may expect from DEC for a specified software 
product. DEC reserves the right to change the category of a software product at any time. 
The four categories are as follows: 



CATEGORY I 
Software Products Supported at no Charge 

This classification includes current versions of monitors, programming languages, and 
support programs provided by DEC. DEC will provide installation (when applicable), advisory, 
and remedial support at no charge. These services are limited to original purchasers of DEC 
computer systems who have the requisite DEC equipment and software products. 

At the option of DEC, a software product may be recategorized from Category I to 
Category II for a particular customer if the software product has been modified by the customer 
or a third party . 



CATEGORY II 
Software Products that Receive Support for a Fee 

This category includes prior versions of Category I programs and all other programs avail- 
able from DEC for which support is given. Programming assistance (additional support), as 
available, will be provided on these DEC programs and non-DEC programs when used in con- 
junction with these DEC programs and equipment supplied by DEC . 



CATEGORY III 
Pre-Release Software 

DEC may elect to release certain software products to customers in order to facilitate 
final testing and/or customer familiarization. In this event, DEC will limit the use of such 
pre-release software to internal, non-competitive applications. Category III software is only 
supported by DEC where this support is consistent with evaluation of the software product. 
While DEC will be grateful for the reporting of any criticism and suggestions pertaining to a 
pre-release, there exists no commitment to respond to these reports. 



CATEGORY IV 
Non- Su ppor ted Software 

This category includes all programs for which no support is given 
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CHAPTER 1 
INTRODUCTION 



1.1 THE DOS MONITOR 

The PDP-11 Disk Operating System (DOS) Monitor is a powerful, 
keyboard-oriented, program development system designed for use on 
PDP-11 computers. The DOS Monitor facilitates use of a wide range 
of peripherals available for use with the PDP-11. 

The DOS Monitor supports the PDP-11 user throughout the de- 
velopment and execution of his program by: 

• providing convenient access to system programs 
and utilities such as the FORTRAN Compiler^ 
the MACRO-11 Assembler^, a Linker, a debugging 
package, an Editor, a file utility package, 
etc. ; 

• performing input/output transfers at four dif- 
ferent levels, ranging from direct access of 
device drivers to full formatting capabilities, 
while providing the convenience of complete 
device independence; 

• providing a file system for management of 
secondary storage? and 

• providing a versatile set of keyboard commands 
for use in controlling the flow of programs. 

System programs and utilities can be called into core from 
disk, DECtape or m.agtape with Monitor commands issued directly 
at the keyboard. This feature eliminates the need to manipulate 

convenient programming tool. 

DOS gives the user program the capability of complete device 
independence. Programs can be written without concern for specific 
I/O devices. When the program is run, the user can select the 
most effective or convenient I/O device available for the function 
to be performed. In addition, if the system configuration is 
altered, many programs can take advantage of the new configuration 
without being rewritten. Logical names can be assigned to devices 
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Available only on 12K or larger systems. The 8K assembler does not 
support macros . 



within the system enabling syirbolic referencing of any device. No 
concern need be given to I/O buffer size within the user program 
yet the user can alternatively retain direct control of I/O buffers. 

All input/output (I/O) transfers are handled by the Monitor in 
any of three user-selected levels called READ/WRITE, RECORD/BLOCK, 
and TRAN. READ/WRITE is a formatted level of I/O in which the user 
can specify any one of nine options. RECORD/BLOCK is a file-structured, 
random- access I/O level with no formatting. TRAN does basic I/O 
operations at the device driver level. All I/O is concurrent and 
interrupt driven. 

The file system on secondary storage uses two types of files: 
linked and contiguous. Linked files can grow serially and have no 
logical limit on their size. Contiguous files must have their 
lengths declared before use but can be randomly accessed by RECORD 
or BLOCK level I/O requests. All blocks in a contiguous file are 
physically adjacent, while blocks in a linked file are typically 
not adjacent (the first word of each block contains the address of 
the next block). Files can be deleted or created at any time, and 
are referenced by name. Table 1-1 summarizes the features and 
benefits of the DOS Monitor. 

The user communicates with the Monitor in two ways : through 
keyboard instructions called commands , and through programmed 
instructions called requests . 

Keyboard commands enable the user to load and run programs; 
assign I/O devices or files; start or restart programs at specific 
addresses; modify the contents of memory locations; retrieve system 
information such as time of day and date; and dump core. Users 
with more than 8K of memory^ can utilize programmed requests, 
which are macros assembled into the user's program and through 
which the user specifies the operation to be performed by the 
Monitor. Some programmed requests are used to access input/output 
transfer facilities, and to specify where the data is, where it is 
going, and what format it is in. In these cases the Monitor will 
take care of bringing drivers in from disk, performing the data 
transfer, and notifying the user of the status of the transfer. 



^8K users must include the code generated by such an assembly (the 
assembly language expansion shown in Appendix E and in the explana- 
tion of each programmed request in Chapter 3) in their programs to 
utilize the Monitor functions. See the MACRO manual 
(DEC-11-OMACA-A-D) for other differences in the 8K Assembler. 
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Table 1-1 
PDP-11 DOS Monitor Features and Benefits 



Feature 

Files are catalogued in multi- 
level file directories. 

Files are referred to by name. 



Files can grow serially. 



Files can be as large as the 
storage device can accept. 

File storage is allocated dynam- 
ically on any bulk-storage 
device. 

Monitor subroutines can be 
swapped into core when needed. 
Routines need not permanently 
tie up an area of core. 



Monitor subroutines can be 
made permanently core resi- 
dent before or during run 
time. 

The Monitor is divided into 
logical modules. 



Benefits to User 

No file naming conflicts am.ong 
users . 

Files do not have to be remem.- 
bered by number. 

Files can be created even when 
their final size is not known. 

No logical limit on the size of 
files . 

Files can be deleted or created 
even at run time for maximum 
storage efficiency. 

Much more efficient use of core 
space for user programs. Free 
core expands and contracts as 
Monitor subroutines are used. 
Space can be reclaimed for user 
program.s . The user can deter- 
mine which Monitor subroutines 
will be in core, and w^hen. 

The user can tailor the Monitor 
for his particular needs. 



The user can easily and effi- 
ciently use the logical pieces 
of the Monitor for his own needs 
He can also easily add his own 
specialized drivers to the sys- 
tem by following a simple set 
of rules, and still use the 
rest of the Monitor with these 
drivers. 



All 1/0 is interrupt-driven, 



Device independence. 



Devices are assigned to one 
or more datasets. 



Such specialized equipment as 
communications modems and A/D 
converters which must be inter- 
rupt driven can be run under the 
Monitor. Several I/O calls can 
be handled concurrently. 

Any device can be specified by 
the user in his program, and 
another device can be substituted 
by him when his program is being 
run. 

The user may reassign a device 
which is used for one purpose 

(dataset) without changing its 
assignment for all other purposes 

(datasets) . 
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other requests access Monitor facilities to query system variables 
such as time of day, date, and system status, and to specify special 
functions for devices. 

Programs supported by DOS, and hence accessible through the 
Monitor, are listed in Table 1-2. 



Table 1-2 



Principal DOS System Programs 



System Program Document Number 

FORTRAN IV DEC-11-LFIVA-A-D 

MACRO-11 Assem.bler DEC-11-OMACA-A-D 

EDIT-11 Text Editor DEC-11-EEDA-D 

ODT-llR Debugging Program DEC-11-OODA-D 

PIP, File Utility Package DEC-11-UPUPA-A-D 

Link-11 Linker and Libr-11 Librarian DEC-11-ULLMA-A-D 



1 . 2 MONITOR CORE ORGANIZATION 

Core memory is divided into: 

• a user area where user programs are located; 

• the stack where parameters are stored tempo- 
rarily during the transfer of control between 
routines; 

• the free core or buffer area which is divided 
into 16-word blocks assigned by the Monitor 
for temporary tables, for Monitor routines 
called in from disk, and for data buffering 
between devices and user programs; 

d the resident Monitor itself which includes 

all permanently resident routines and tables; 

• The interrupt vectors. 

Figure 1-1 is a map of core as organized by the Monitor. 

The DOS Monitor dynamically acquires and releases core on the 
basis of system requirements. 
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xxiue, 



000000 



STACK 



Free Core 



Device Assignment Table 
Generated After Load Time 



Monitor Buffers 
(Data Buffers, Data Control 
Blocks, Drivers, etc.) 



Device Assignm.ent Table 
Generated Before Start of Program. 



Monitor Routines Resident 
for Program Duration 



Device Assignment Table 
Generated Before Load Time 



.Top of Core (.CORE) 



Base of User (.GTPLA) 
Programs 



^,Top of Full (.MONF) 
Monitor 



Top of Resident 
^Monitor (.MONR) 



Permanently Resident Monitor 
and Vectors 



Figure 1-1 The Monitor Core Map 
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1.3 HARDWARE CONFIGURATIONS 

Many minimum hardware configurations for use by the disk opera- 
ting system may be derived by choosing one item from each of the 
five following sets. 

9 PDP-11 System Building Block with 900 nsec. Core Memory 

and a Terminal (DECwriter [LA30] , Alphanumeric CRT 
[VT05-B] , or Teletype^ [LT33] ) . 

• Cabinets and all Mounting Hardware. 

<» Bootstrap Loader (BM792-YB or MR-11) . 

• Choice of Disks (Control Logic Included) 

64K word Fixed Head Disk (RS64/RC11) 

256K word Fixed Head Disk (RFll/RSll) 

1.2 word Interchangeable Cartridge Disk (RK05/RK11) 

V Choice of Tape Devices (Control Logic Included) 

Dual Drive DECtape (TU56/TC11) 

7- or 9-track Industry Standard Magnetic Tape (TUlO/TMll) 

High-Speed Paper Tape Reader/Punch (PCll) 

Specific details are available from a sales representative. Note 
that 12K of core is required with the RK disk and DECtape is required 
with the RC disk. 

1.4 MONITOR MESSAGE 

When a message-producing situation (such as a system error) 
occurs, an error code and an additional word of information are dis- 
played on the teleprinter. There are five types of messages: 

• Informational 

• Action required by the operator 

• Warning to the operator 

• Fatal 

• System Program error 

The type of message is identified by being preceded by the letter 
I, A, W, F or S respectively. If the system disk should fail and 
the error message cannot be brought into core, the Monitor halts. 

Monitor messages are described in detail in Appendix F. 



^Teletype is a registered trademark of the Teletype Corporation. 
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1.5 STARTING THE MONITOR 

The Monitor is called into core from disk by performing the 
following procedure for systems with the BM792yB: 

1. If the system device is an RKll Disk, turn WRITE 
ENABLE off; 

^« i>'iOvs liAxj'j.'/ iir-jriijxjij swiucn uG iiiij-iT posiuj-on/ 

3. Load the processor switch register with 17310j2f; 

4. Depress LOAD ADDRESS processor switch; 

5. Load the switch register with, 

177462 if the system device is RFll disk, 
177406 if the system device is RKll disk, 
177450 if the system device is RCll disk; 

6. Move HALT/ENABLE processor switch to ENABLE position; 

7. Depress START processor switch. 

With the MRU Bootstrap Loader, the procedure is: 

1. Load the processor switch register with: 

173100 if the Monitor storage device is RFll disk, 
173110 if the Monitor storage device is RKll disk, 

2. Move HALT/ENABLE switch to HALT position; 

3. Move HALT/ENABLE switch to ENABLE position; 

4. Depress LOAD ADDRESS processor switch; 

5. Depress START processor switch. 

TVio Mr>r) i -i-mir TuTiII 1 nari in+-o r«r»-rc» ::»-nri t i^a-n-h t ■f\T it-col-F hf^r -nvi n-t-i -nrr • 

DOS Vxx 

on the teleprinter, where Vxx represents the version number of the 
Monitor being used. The Monitor is now ready to accept an operator 
command (see Chapter 2). 
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1.6 A GUIDE TO THIS HANDBOOK 
1.6.1 Terminology 

The reader should understand the following terms as they apply 
to the PDP-11 Disk Operating System. An expanded Glossary, with 
abbreviations , can be found in Appendix I . 

A dataset is a logical collection of data which is treated as 
an entity by a program. Typically, the items in a dataset have 
a realtionship to each other which simultaneously binds them to- 
gether and distinguishes them from items in other datasets. For 
example, the records in the Object dataset produced by the assembler 
are clearly related to each other and are clearly distinct from the 
listing dataset produced by the same assembler. A parameter file 
and a source file, when presented successively to the assembler, 
might be viewed as a single dataset, however. 

Typically, each dataset is associated with exactly one link 
block (see section 3.8.6.1), although a link block can be associ- 
ated (successively, not simultaneously) with more than one dataset. 
For example, when the assembler finishes processing one dataset 
and returns for another command, the new input will constitute a 
new dataset, but the same link block will be used. 

Examples of datasets are: 

o all or part of a file on a file-structured 
device; 

• one or more paper tapes in a paper tape reader; 

• a deck of cards, terminated by an EOF card; 

• three lines of keyboard data, a disk file, 
and a paper tape; which are read in sequence 
by the assembler and are viewed as the source 
input dataset. 

A device is any PDP-11 peripheral supported by the Monitor. 

A device controller can support one or more device units. 

A file is a physical collection of data which resides on a 
directory device (e.g., disk or DECtape) and is referenced by its 
name. A file occupies one or more blocks on a directory device. 
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On a directory device it is possible to store data by name, rather 
than simply physical location; it is also called a file-structured 
device. 

Bulk storage devices containing directories are called direc - 
tory devices or file-structured devices . Devices such as paper 
tape equipment and the teleprinter ^ which cannot support a file 

devices . 

A block is a group of adjacent words of a specified size on 
a device; it is the smallest system- address able segment on the 
device. If the blocks comprising a file are physically adjacent 
to each other, the file is said to be contiguous ; if the blocks 
of the file are not physically adjacent, the file is said to be 
linked . 

A line is a string of ASCII ^ characters which is terminated by 
a LINE FEED, FORM FEED or VERTICAL TAB. 

File structure refers to the manner in which files are organ- 
ized. Specifically, each of a user's files is given a unique name 
by the user. Each user on a file-structured device is assigned a 
User File Directory (UFD) in which each of his files is listed by 
name and location. Each UFD is then listed in a Master File Direc- 
tory (MFD) which is unique to a specific device unit, 

1.6.2 Standards for Tables 

A table is a collection of data stored in sequential memory 
locations. A typical table as represented in this manual is shown 
below. This table is two words long, and is referenced by the sym- 
bolic address TABL:. The first entry is at location TABL and con- 
tains ENTRY A, which might be coded as .WORD AYE in the user's pro- 
gram. The second word of the table, at address TABL+2, is divided 
into two bytes. The low-order byte (address TABL+2) contains ENTRY 
B, and the high-order byte (address TABL+3) contains ENTRY C. They 
might be written into a program as .BYTE BEE,CEE. 



^ ASCII represents American Standard Code for Information Interchange 
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a) Representation in manual 



TABL: 



ENTRY A 



ENTRY C 



ENTRY B 



b) Representation in program listing: 



TABL: .WORD AYE 

.BYTE BEE,CEE 



; ENTRY A 

; ENTRY B, ENTRY C 



Note that the first byte specified is stored at the rightmost avail- 
able byte. 

1.6.3 Standards for Numbers 

Unless otheirwise stated, all numbers in the text and examples 
are in octal form. 
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CHAPTER 2 
MONITOR KEYBOARD COMMANDS 



2 . 1 INTRODUCTION 



looks to the user as he sits at the terminal (i.e., the Teletype, 
DECwriter, etc.). The user is coiranunicating with the DOS Monitor 
while running system, utility, and user programs. 

Since DOS is an interactive operating system, the primary input 
and output device is the user's terminal or teleprinter (keyboard 
and printer) . Through the terminal keyboard, the user can communi- 
cate with 

• the Monitor, 

• a system or utility program (Macro, PIP, Editor, 
etc. ) , or 

• a user program written to run under DOS . 

The terminal printer is used to record user input and system output. 

In communicating with the Monitor, the keyboard is used as a 
control device to allocate system resources, move programs into 
core, start and stop programs, and exchange information with the 
system. Data from the keyboard may be transferred to a buffer in 
the user program or it may be processed immediately by the DOS 
Command String Interpreter (CSI) as explained in Appendix I. In 
this Chapter, the CSI is described only as it applies to the format- 
ting of Monitor keyboard commands . 

When the system is ready for input from the keyboard, a 
single character is printed on the teleprinter. The following con- 
ventions apply: 
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Character Meaning 

$ The system is idle , waiting for a Monitor com- 
mand. 

V A. 

The Monitor is waiting to continue or abort a \^ ^^"^ 
task . ) J 



# A system, utility, or user's program requests jr?^ 
a command through the CSI. 






* A system program requests direct input, i.e., 
not through the CSI. 

In this Chapter, we are concerned only with the $ and . characters. 
The # and * characters are explained in the individual system and 
utility programmer's manuals. 

The $ and . indicate that the Monitor is waiting for a keyboard 
command from the user. Note, however, that some commands may be 
issued only to a $ and some only to a . , and that each command has 
different limitations; these are discussed with each command in 
Section 2.8. 

2.1.1 Monitor Commands by Function 

A number of keyboard commands are provided for communication 
with the DOS Monitor. These commands are briefly identified by 
function in Table 2-1 and are fully described in Section 2.8. 



Table 2-1 
Monitor Commands by Function 

Function Command 

Establish identity of user LOGIN 

Terminate a session before leaving the system FINISH 

Enter or retrieve date DATE 

Enter or retrieve the time-of-day TIME 

Load and execute a program RUN 

Load a program GET 

Start a program which has been loaded BEGIN 

Resume a program that is waiting for user action CONTINUE 

(continued on next page) 
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Table 2-1 (Cont'd) 
Monitor Commands by Function 



Function 



Command 



Assign an I/O device or a file at run-time ASSIGN 

Inspect or modify individual mem.orv locations MODIFY 

Save a program in core for later use SAVE 

Dump memory data on the teleprinter DUMP 

Suppress or resume echoing of keyboard input ECHO 

Suppress or resume teleprinter output PRINT 
Start the program just loaded at its ODT entry point ODT 

Stop a program STOP 

Cnor^O^^'^ 3 r-\-v/~\rT'V- rsTYi TaTTV Tin 

u.' w.t^^C'J.J.Vi. *-* ^ J. \^ ^ ^ Cu.\.i ir¥Z~l J. J. 

Restart a program that has been running RESTART 

Terminate a keyboard or paper tape dataset END 



2.1.2 When Monitor Commands are Legal 

Each command performs a specific function, is legal to use 
under specific conditions, and often alters the state of the system, 
as shown in the following table. 



Command 


Legal When: 


State Induced 


ASSIGN 


any time 


no change 


BEGIN 


program loaded and stopped 


program running 


CONTINUE 


program loaded and waiting 


program running 


DATE 


any time 


no change 


DUMP 


any time 


no change 


ECHO 


program running 


no change 



(continued on next page) 
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Command 



Legal When ; 



State Induced 



END program running 

FINISH no program loaded 

GET no program loaded 

KILL program loaded 

LOGIN not logged in 

MODIFY any time 

ODT program loaded and stopped 

PRINT program running 

RESTART program loaded and stopped/waiting 

RUN no program loaded 

SAVE program loaded and stopped 

STOP program running 

TIME any time 

WAIT program running 



no change 

logged out 

program loaded and stopped 

program stopped and unloaded 

logged in 

no change 

program running under ODT 

no change 

program running 

program loaded and running 

no change 

program stopped 

no change 

program waiting 



A program is loaded if you have typed RUN or GET but not KILL, 
and as long as the program has not executed a .EXIT call (see Chap- 
ter 3) . 

A program is running if you have typed RUN or if it has been 
loaded and you have typed BEGIN, CONTINUE, RESTART, or ODT. 

A program is loaded and stopped if GET but not BEGIN was typed, 
if it was running and a STOP was typed, or after issuing a fatal 
error message (see Appendix F) . 

A program is waiting if it was running and you typed CTRL/C 
followed by WAIT, or after the system issues an action error message 
(see Appendix F) . 

A program is stopped and unloaded (from core) if you have 
typed KILL or if the program issued an .EXIT call (see Chapter 3). 

2.2 MONITOR MODE AND USER MODE 

From the user's point of view, his terminal is in either 
Monitor mode or user mode. In Monitor mode, each line the user 
types is sent to the Monitor's Command String Interpreter (CSI) . 
The execution of certain commands places the terminal in user mode. 
When the terminal is in user mode, it becomes simply an input/ 
output (I/O) device for that user. In addition, user programs use 
the terminal for two purposes: to accept user command strings (user 
mode) or as a direct I/O device (data mode) . 
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2.3 COMMAND STRING INTERPRETER (CSI) 

When the terminal is in Monitor mode the user communicates 
with the Monitor's Command String Interpreter (CSI). The commands 
described in this Chapter are processed by the CSI (see Appendix I) . 

The CSI makes several checks before processing commands from 
the user. For example, if a user who has not logged in types a 
command that requires him to be logged in, the system responds with 
the message: 

ILL CMD! 

meaning the command was illegal and was not executed. The comm.ands 
discussed in this Chapter require that the user be logged in except 
where explicitly stated otherwise. When a command is issued that 
requires the job to use more core than is available, the system re- 
sponds with the message: 

NO CORE! 

and the user's command is not executed. 

All Monitor messages are shown in Appendix F. 

2.4 USER IDENTIFICATION CODE (UIC ) 

Each user of the system is normally assigned a User Identifi- 
cation Code (UIC) by the system or installation manager. The UIC 
is first used when logging in to the system, as explained in Sec- 
tion 2.7. The format of the UIC is: 

nnn,nnn 

where nnn represents a string of two or three octal digits, from 
11 to 376 (0-10 and 377 are reserved for the system) . The value 
to the left of the comma represents the user-group number, while 
the value to the right represents the user's number within the 
group. 
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For example: 

67,123 
specifies user group 6 7 and user number 12 3. 

NOTE 

Except when logging in, the UIC is always de- 
limited by the left and right square brackets, 
as shown in the examples of various commands 
in this Chapter. 

2.5 FILENAMES AND FILENAME EXTENSIONS 

User program files are named with a certain convention, much 
the same as a person is named. For example, the first name is 
the filename and the second name is the filename extension. By 
convention, the filename and extension are separated by a period. 
For example: 

GEORGE. DOE 

could be a legal filename and extension. Note that the filename and 
extension cannot have embedded blanks (spaces) because a space will be 
interpreted as a delimiter, 

Filenames can consist of from one to six alphanumerics; all 
after the sixth are ignored. The filename extension can consist 
of from one to three alphanumerics. The extension is generally 
used to indicate the type of information in the file. For example: 

File Could be: 



MAIN.F4 a FORTRAN file named MAIN 

SAMPLE. MAC ^ Macro source file named SAMPLE 

TESTl.TMP a temporary file named TESTl 

NAME.REL a relocatable binary file named NAME 

A list of standard extensions are shown in Appendix 

User program files are identified by the filename. extension 
^^^ the UIC. Thus, different users may use the same filename. exten- 
sion, and as long as they are created under different UIC's the 
files would remain distinct and separate. 
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2,6 SPECIAL KEYBOARD CHARACTERS 

There are several special keyboard characters recognized by 
the Monitor's CSI that cause specific functions to be performed. 
These keyboard characters are explained below. 

2.6.1. The, RETURN Key 

The RETURN key is used to teinninate a keyboard command and 
to advance the teleprinter paper one line. Typing the RETURN key 
produces a carriage return and line feed action on the teleprinter, 

As characters are typed, they are transferred into a buffer 
where they are stored until the RETURN key (or another special 
keyboard character (s) ) is typed. When the RETURN key is typed, 
the data on that line is transferred to and processed by the CSI. 

All legal command strings are terminated by the RETURN key. 

2.6.2 The RUBOUT Key 

The RUBOUT key is used to correct typing errors. Typing the 
RUBOUT key once causes the last character typed to be deleted; 
typing it twice causes the last two characters to be deleted; etc. 
The Monitor prints the deleted characters delimited by backslashes. 
For example, if you meant to type ASSIGN but typed ASIS instead, 
the error could be corrected by typing two RUBOUTs and then the 
correct characters. The printout would be: 

ASIS\ SI \SIGN 

Notice that the deleted characters are shown in reverse order, 
i.e. , in the order in which they are deleted. 

2.6.3 The CTRL/C Keys 

The CTRL/C key combination is typed by holding down the CTRL 
key while typing the C key. When CTRL/C is typed, the Monitor is 
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alerted to accept a command from the keyboard. CTRL/C is echoed 
on the teleprinter as fC, carriage return, line feed, and period. 

CTRL/C interrupts teleprinter output or keyboard input in a 
user program. Monitor action on a CTRL/C is not taken until any 
current Monitor command is completed because the keyboard interrupt 
is turned off. However, except for DUMP and MODIFY, it appears to 
the user that action on a CTRL/C is immediate. 

CTRL/C puts the Monitor in listening mode only. If it is 
desired to stop the function of the operating program, the STOP 
command should be used. 

If a second CTRL/C is typed before the RETURN key terminating 
a command, the input so far will be erased, a fresh fC will be 
printed, and the Monitor will await a new command. 

2.6.4 The CTRL/U Keys 

The CTRL/U key combination is typed by holding down the CTRL 
key while typing the U key. When CTRL/U is typed, the line on 
which it is typed is deleted; the system responds with a carriage 
return and line feed so that the line (command) may be typed again. 

CTPJj/U is echoed on the teleprinter as +U, carriage return, 
and line feed. 

2.6.5 The Semicolon Key 

When the Monitor is in listening mode (i.e., following a 
CTRL/C), the semicolon ( ; ) key causes subsequent characters on the 
line to be treated as a comment. It effectively puts the keyboard 
off-line so that all characters following the semicolon are printed 
on the teleprinter but no Monitor action is taken. 
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The ESCAPE key (ASCII 033 octal) may be used to pass special 
keyboard characters to a running user program. When the CSI de- 
tects the ESC key it passes the next character directly to the 
user program. The use of this feature is under programmer control. 

2.6.7 How Keyboard Characters are Processed 

As characters are typed they are stored in the keyboard buffer 
(about 85 characters capacity) pending termination of the line with 
a RETURN, CTRL/C, or CTRL/U, which transfers the line of characters 
to the Monitor buffer. 

When a RUBOUT is processed, it remains in the keyboard buffer 
and the character which it deletes is replaced with another RUBOUT. 
Since RUBOUTs are not removed until the line is transferred to the 
user, the capacity of the keyboard buffer may be exceeded if the 
sum of normal characters plus RUBOUTs is greater than 85. When 
this occurs, only RETURN, CTRL/C, or CTRL/U is accepted; all other 
characters are discarded and not echoed. This is done to maintain 
economy of core and to ensure that characters such as CTRL/C and 
CTRL/U can be processed correctly, even when they appear at the 
end of a very long line. 

CTRL/C and CTRL/U characters are processed immediately. 



2-9 



2.7 GETTING ON THE SYSTEM 

In order to gain access to the system, the user must log in 
with the LOGIN command (see section 2.8.11). First, ensure that 
the terminal is connected to the system (see Appendix H) . The 
LOGIN command is issued in response to the Monitor's $. If none 
exist on the teleprinter paper, type the RETURN key and a $ will 
be printed by the Monitor; if not, a new Monitor must be loaded 
as described in the Batch/DOS-11 System Manager's Guide. 

In response to $, the user should issue the LOGIN command 
with his User Identification Code (UIC) (see section 2.4). For 
example: 

£LOGIN 20)2^,200 
DATE;-20-OCT-72 
TIME: -10: 41: 16 " 
I 

NOTE 



In the examples, underscoring is used to designate 
system printout, whereas user input is not under- 
scored. 

In response to the LOGIN command, the Monitor prints the cur- 
rent calendar date and time-of-day followed by the $, indicating 
that the system is ready for a Monitor command from the user. 

Only one user can be logged in at a time. The LOGIN command 
will be rejected when it is given before the previous user has 
logged out with the FINISH command. 
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2.8 MONITOR KEYBOARD COMMANDS 

A keyboard command to the Monitor consists of two parts: a 
command name and possibly one or more command arguments. A com- 
mand name is a string of two or more letters; all letters after 
the first two and up to a command name delimiter (space or comma) 
are ignored. 

Monitor keyboard commands are typed in response to a dollar 
sign ($) or a period (.), which is printed by the system. Gener- 
ally speaking, the $ indicates that the Monitor is waiting for a 
new task, and the . indicates that the Monitor is waiting to con- 
tinue or abort a previously assumed task. 

Although the commands are arranged in alphabetical order for 
ease of reference, they can be divided into functional groups for 
ease of learning. These groups with their associated commands 
are as follows: 

• Comm.and to allocate system, resources : 

ASSIGN 

• Commands to manipulate core images: 

RUN GET 

DUMP SAVE 

• Commands to start a program: 

BEGIN CONTINUE 

RESTART 

• Commands to stop a program: 

STOP WAIT 

KILL 

• Commands to exchange information with the system: 

DATE TIME 

LOGIN MODIFY 

FINISH 

• Miscellaneous commands: 

ECHO PRINT 

END ODT 
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The following conventions apply to all Monitor commands: 

• All commands are terminated with the RETURN key. 

• The command name is separated from its argu- 
ment (dataset specifier, etc. ) with a space. 

• All characters in a command are interpreted by 
the CSI; thus, no embedded blanks are allowed. 

• The UIC is always enclosed within square brackets, 
[ ] , except when used with the LOGIN command. 

The proper format for each command is given in the discussion 
of each command in this section. The following conventions apply 
to the command formats shown in this section. 



Brackets [ ] are used to enclose optional elements 

Braces { } are used to indicate that a choice must 
be made from the enclosed elements 

The symbol A indicates that a space must appear there. 

dev: refers to a device mnemonic (see Appendix A) . 

dataset specifier may be represented by any portion 
of the expression: 



dev: filename. ext, [uic] 



where 



dev: 



filename 



.ext 



[uic] 



is a legal device mnemonic and 
colon 

is a filename of up to six alpha- 
numerics 

is a period and filename extension 
of up to three alphanumerics 

is the user's identification code 
in the form: 

[group no., user no.] 



logical name is the name given by the user to the 
dataset in Link Block word LNKBLK+2 (see Chapter 3) . 



If for any reason a command cannot be executed satisfactorily, 
an appropriate message will be printed on the teleprinter and the 
command will be ignored. These messages are shown in Appendix F. 



2-12 



ASSIGN 



2.8.1 The ASSIGN Coinmand 



Format: 



AS [SIGNjAdev: [dataset specifier, logical name] 

Purpose: 

This coinmand assigns a physical device (and a filename when 
the device is file-structured) to the dataset identified by "logical 
name". The format of "dataset specifier" is: 

f ilenam. ext [uic] 

which designates the name, extension, and uic, if any, to be as- 
signed to the file. 

Any filename specified for a nonfile-structured device is 
ignored. 

Note that a device is assigned to a dataset, and that reas- 
signing it for one dataset does not reassign it for all datasets. 

The ASSIGN command overrides any assignment made in the pro- 
gram's internal control blocks (Link and Filename Blocks). The 
ASSIGN command is not needed if the program makes its own provi- 
sions for obtaining this information; e.g., by specifying defaults 
in its control blocks or by requesting a coirmand string, as is done 
with the # symbol in the DOS system programs. 

An ASSIGN with no argum ent releases ( deassign) all ASSIGNments 
previously made by the current user, i.e., since the last LOGIN 
command 

The ASSIGN command can be given at any time the Monitor is 
in core. Consider the following: 
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If ASSIGN is given before a program is loaded, the 
device assignment will remain in effect until an- 
other ASSIGN is given with the same logical name 
or with no argiiments , or until the Monitor itself 
is reloaded. ASSIGN, given at this time, enables 
the user to specify an assignment which will apply- 
to several programs. 

If ASSIGN is given after a program is loaded and 
before it has started running (i.e. , after a GET 
command) , the assignment will remain in effect as 
long as the program is in core, or until another 
ASSIGNment is performed. When the program disap- 
pears (by an .EXIT request or a KILL command) , the 
assignment is released. 

ASSIGN may also be given after a program is running, 
For example , as a recovery from an 

A^j2f3 (device not ready) 

message, the user would do an ASSIGN followed by 
a CONTINUE. The assignment will remain in effect 
as long as the program is in core, or until the 
programmer reassigns the dataset, or until he re- 
starts the program with a BEGIN command. 

Doing an ASSIGN in this manner is provided for 
such emergency situations, but is not recommended 
as standard practice because it causes an extra 
buffer to be allocated from free core, and it will 
be effective only if the program has not already 
INITed the dataset to some other device. 
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BEGIN 



2.8.2 The BEGIN Coinmand 



Format : 



BE [GIN] A [address] 

Purpose: 

The BEGIN command starts the execution of an already loaded 
program at the stated address. If no address is specified, the normal 
start address will be used. This command is valid only if a program 
is already in core. 

BEGIN is used after a GET, a STOP, or following a fatal error 
condition. The GET command followed by a BEGIN command is equiva- 
lent to a RUN command. If given after a program has been started, 
a BEGIN will restore core to the state which existed immediately 
after the program was loaded. It will rename all core allocations 
to buffers, device drivers, and assignments made dynamically, and 
the stack will be cleared before control is passed baclc to the pro- 
gram. If any files are under creation at this time, they will be 
deleted (see section 2.8.15). 

To start a program at its normal start address, type: 

BE 

To start a program at absolute address 3446, type: 

BEA3446 
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After a Program Crash : 

The BEGIN Command is provided not only as a means of starting 
a program loaded by GET but also to enable the user to try again 
after a program crash, hopefully with a clean slate. At the time 
of the crash, the program may already have opened but not closed 
output files and the subsequent request to reopen after a restart 
could then lead to other failure because these files now exist. To 
prevent this, the BEGIN processor tries to delete the files, but not 
by the normal Monitor process since this could mean writing out bit- 
maps which are currently in core and must be suspect because of the 
crash. Instead, it merely removes the names of the files from the 
appropriate device directory, and if these are on disk, unlinks any 
blocks so far allocated; for safety it does not touch the bit-maps 
already stored on the device. In almost all cases, this procedure 
suffices. However, the following implications should be noted. 

1. This automatic deletion by BEGIN will not suit a 
user who has already amassed considerable data in 
one of his output files and cannot replace it if 
he starts over. In this case, KILLing the program 
to save his data under a different filename might 
be a more appropriate action. However, he should 
then realize that he might be transmitting the ef- 
fects of his program failure to the device concerned, 

2 . It is possible that by the time of the crash the 
program may have produced a fairly long file. On 

a DECtape for which there is only one bit-map, this 
is no problem. A disk, however, requires several 
bit-maps and the allocation of some of the blocks 
for the file may already be permanently recorded 
because the appropriate bit-map has been filled and 
has been replaced in core by another. Since BEGIN 
does not change the maps, these blocks will not be 
freed for further use. A series of situations such 
as this can, after a time, result in the disk becom- 
ing full even though the known files are not seen to 
occupy the whole capacity. The user should in this 
case consider whether or not he should chance disk- 
corruption and use KILL rather than BEGIN. The user 
can then delete the file by using PIP-11 to avoid the 
build-up of the nonavailable blocks described. 
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Some programs cannot be restarted with BEGIN (i.e., 
after having been started, they cannot be restarted 
with BEGIN.) A FORTRAN program is an example. In 
general, a program must be self -initialized if BEGIN 
is to be used in this way. Also, since the Monitor 
will try to clean up core and delete files, reBEGIN- 
ning a program which was badly out of control may 
lead to undesirable results. Thus, use BEGIN only 
if there is no other alternative. 
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CONTINUE 



2.8.3 The CONTINUE Coramand 



Foinnat: 



COINTINUE] 

Purpose: 

This command is used after a WAIT command or a recoverable error 
condition (operator action message) to resume program operation at 
the point where it was interrupted. 

CONTINUE is valid only if a program is already in core. 
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DATE 



2.8.4 The DATE Command 



Format : 



DA[TE]A [date] 
Purpose: 

The DATE command may be used to obtain the current calendar 
date and to enter a date value from the keyboard; the date is 
printed in the dd-mmm-yy format. 

To obtain the current calendar date, simply type the DATE 
command followed by the RETURN key. For example: 



$pATE 
20-OCT-72 



The current calendar date is entered by the system or installation 
manager, and need not be reentered except when loading a new DOS 
Monitor. 

To enter a date value from the keyboard, type the DATE 
command, the desired date value, and then the RETURN key. 
For example: 

£DATE a dd-mmm-yy 

putting the desired date value in place of dd-mmm-yy. The entered 
date value is returned in response to subsequent DATE commands 
until another date is given. If the desired date value is 
an invalid date, e.g., 42-BOB-Al, subsequent responses to DATE 
will be meaningless, e.g., j0j3-XXX-YY. 

DATE is valid at any time. 
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DUMP 



2.8.5 The DUMP Command 



Format : 



DU[MP]AlP: [0] , 
9 



I start addr 



[,end addr] 



Purpose: 



The DUMP command is used to print on the Line Printer an abso- 
lute copy of the contents of the specified core area, formatted in 
octal. The core image is not altered. 

The argument O specifies the dump to be output from core. An 
is assumed on default, but the comma is required. 

The argument J2f is assumed if no "start address" is specified 
and the highest word in core is assumed if no "end address" is speci- 
fied. 

DUMP is valid at any time. If given while a program is run- 
ning, the operation of the program will be suspended for the time 
required to effect the dump. 

The syntax of the DUMP command was chosen to facilitate later 
expansion and flexibility of the command. 
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ECHO 



2.8.6 The ECHO Command 



Forroat; 



EC [HO] 

Purpose; 

The ECHO command may be used to suppress and restore keyboard 
echo, i.e., characters typed by the user will not appear on the 
terminal printer. A subsequent ECHO command turns the echo feature 
on again. The teleprinter as an output device for the program or 
the Monitor is not affected by this command. 

ECHO is valid only when a program is running in core and using 
the keyboard as an input device. 
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END 



2.8.7 The END Command 
Format: 

en[d]a|^^ 

Purpose: 

The END command is used to terminate using the console as an 
input device, i.e. , the keyboard or low-speed paper tape reader. 
The command tells the Monitor "there is no more input from the 
device". The command effectively generates an end-of-file (EOF) 
from the keyboard. 

When no device is specified in the command, KB is assumed. 

The following actions are required with this command 

1. Type CTRL/C to obtain the Monitor's attention. 
Since the console is being used for program input 
(data mode) , the Monitor is not expecting a com- 
mand. 

2. Issue the END command (with appropriate argument). 

3. Type the RETURN key twice; yes, two RETURNS. The 
two RETURNS are required to return to the Monitor. 

For example: (where fC = CTRL/C, and (CR) = RETURN) 

+ C 

_^END,KB (CR) (CR) 

END is valid only when the console is being used as an input 
device. 
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FINISH 



2.8.8 The FINISH Command 



FI[NISH] 

Purpose : 

The FINISH command informs the Monitor that the current user 
is leaving the system. The Monitor deletes all files which are 
not protected against automatic deletion on FINISH (see Section 
3.9.2.2), and a new copy of the resident Monitor is "booted" into 
core. 

FINISH is valid only when no user program is in core. There- 
fore, unless the last character on the teleprinter is a $ , the 
user should precede a FINISH with CTRL/C followed by KILL. For 
example, the printout might be: 

f_C 

_^KILL 

^FINISH 

TIME: -16: 42: 00 

MONITOR VJZI8-02 

i 

In response to a FINISH, the Monitor prints the time and then the 
newly booted Monitor identifies itself. The system is now ready 
for a user to log in. 
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GET 



2.8.9 The GET Command 



Format : 



GE [T] A dataset specifier 

Purpose; 

The GET command loads the specified file from the specified 
device. When a device is not specified, the system device is as- 
sumed. 

GET is valid only when no program is in core. 

The user should use a BEGIN or ODT command to commence exe- 
cution. 
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KILL 



2.8.10 The KILL Command 



\y J-J.li.(^ \ 



KI[11] 

Purpose: 

The KILL command stops the execution of the current program 
after closing all open files and completing any outstanding I/O. 
It then removes the program from core by returning control to 
the Monitor. 

KILL is valid only when a program is in core. 

To resume operations, the user must reload the program or 
load another with RUN or GET. 
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LOGIN 



2.8.11 The LOGIN Command 



Format : 



LO[GIN]Auic 

Purpose: 

The LOGIN command enables a user to gain access to the system. 
LOGIN requires a UIC as its argument (see section 2.4). The UIC 
indicates which directory (of several possible) , on each file- 
structured device, will be directly available to the user. 

Here the UIC is not enclosed within the square brackets; its 
format is simply 

nnn,nnn 
specifying group, user numbers respectively. 

LOGIN is valid only when there is no program loaded in core 
and provided no user has logged in and not logged out (FINISHed) . 
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MODIFY 



2.8.12 The MODIFY Command 



Format ; 



MO[DIFY] A octal address 

octal address/contents; [new contents] 



Purpose 



This command allows the user to display and make changes to the 
contents of the absolute memory location specified by "octal address" 
in the command line. When the RETURN key is typed at the end of the 
command line, the system responds by printing the contents of that 
address. At this point, the user can type one of the following 
( (CR) = RETURN key; (LF) = LINE FEED key): 

(CR) will leave the contents unmodified. 

new contents (CR) will change contents to new contents. 

(LF) will take similar action as CR and 

then automatically print the contents 
of the next memory location. 

To change the contents of location 40000: 

$MODIFYA40000 (CR) 
40000/16406: 10406 (CR) 



Then to examine the contents of 40000 



$MOA40000 (CR) 
40000/10406: (CR) 



To examine the contents of locations 40000 and 40002, the sequence 
would be: 



£MOA40000 (CR) 
40000/104060: (LF) 
40002/000003: 
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Entry of an address outside the available core memory as part 
of the original MODIFY command will cause an error, and the command 
will be rejected. 

MODIFY is valid at any time. 
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ODT 



2.8.13 The ODT Command 



Format : 



OD[T] A 



Purpose; 

The ODT command starts the execution of the ODT-llR Debugging 
Program. The argument specifies which ODT start address is to be 
used: 



Argument 
(none) 



Starts at Action 

START+j2( Clears ODT breakpoint table with- 
out resetting breakpoints. 

START+2 Clears ODT breakpoint table after 
replacing old instructions at 
breakpoints. 

START+4 Leaves breakpoints exactly as 
they are. 



This command begins execution at the ODT entry point of the 
user's load m.odule. The user must have linked ODT-llR with his 
program and must have identified his program to the Linker with 
the /OD switch. 

To reset all breakpoint locations at their former instruc- 
tions and restart ODT, the user would type: 



.ODAR 



ODT is valid only when ODT-llR is linked to a program and 
both are in core. 
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PRINT 



2.8.14 The PRINT Conunand 



Format: 



PR [INT] 

Purpose: 

The PRINT command may be used to suppress and restore tele- 
printer printing when the printer is used as an output device to 
a user program. A subsequent PRINT command turns the printing 
feature on again. 

PRINT is valid only when a program is running in core and is 
using the teleprinter as an output device. 
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RESTART 



2.8.15 The RESTART Command 



Format: 



RE [START] A [address] 



Purpose; 



The RESTART command permits a program to be restarted. As shown, 
the user may optionally supply an address at which the program is to 
be restarted. If no address is specified, the address set by the 
.RESTART programmed request is assumed if^ a .RSTRT request has 
been issued by the program (see Section 3.8.3.2). 

If neither address is specified, the command is rejected. 

RESTART is valid only when a program is already in core. 

Before the program is restarted, the stack is cleared, any 
current I/O is stopped, and all internal busy states are removed. 
Buffers and device drivers set up for I/O operations will, how- 
ever, remain linked to the program for future use. 
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RUN 



2.8.16 The RUN Coinmand 



Format: 



RU[N] A dataset specifier 

Purpose: 

The RUN command loads into core the specified program from the 
specified device and starts its execution at the normal start ad- 
dress. RUN is equivalent to a GET command followed by a BEGIN com- 
mand. 

The dataset specifier is of the form: 

dev: f ilenam.ext [uic] 

When no device is specified, the system device (disk) is assumed. 

The sequence in which the Monitor performs its search for the 
specified program depends on the existence and type of filename ex- 
tension and on the UIC. Various forms of the RUN command are shown 
below with the search sequence performed by the Monitor. 



RUNAFILE 



Attempt 1 — FILE.LDA [current uic] 
Attempt 2 — FILE.LDA [1,1] 
Attempt 3 — FILE [current uic] 
Attempt 4 — FILE [1,1] 



RUNAFILE .EXT 



Attempt 1 — FILE. EXT [current uic] 
Attempt 2 — FILE. EXT [1,1] 



2-32 



• RUNAFILE[x,x] 

Attempt 1 — FILE.LDA [x,x] 
Attempt 2 — FILE [x,x] 

• RUNAFILE.EXT[x,x] 

- Attempt 1 — FILE. EXT [x,x] 

If all attempts fail to find the file, a NO FILE message is printed 
on the teleprinter. 

Searching for the LDA extension first exploits the fact that 
both the Linker and the SAVE command produce LDA extensions, unless 
the user specifies otherwise. 

RUN is valid only \i7hen there is no program in core. 
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SAVE 



2.8.17 The SAVE Command 



Format: 



SA[VE] A [dataset specifier] [/RA: low: high] 



Purpose: 



The SAVE command writes the program in core onto the device in 
loader format. The core image is not altered. SAVE is valid only 
when a program is in core but not running, i.e., immediately after 
loading with a GET command or after being halted by either a STOP 
command or a fatal error. 

If no dataset specifier is given, the SAVE processor will 
automatically set up a file called SAVE.LDA on the system disk 
after it has deleted any current file of the same name. If the 
user wishes to retain the current file, he must first rename it 
using PIP-11. If the dataset specifier is given, the file named 
must not already exist or the command will be rejected. System 
disk is assumed by default if the dataset specifier contains only 
a filename. When the filename is specified, the extension should 
also be specified. 

Normally it is expected that the user will only wish to save 
his program area. If this is the case, the range need not be 
given and the new file will begin from the program's low limit and 
extend to the top of core. If any other area is to be saved, the 
user should include the following at the end of the command: 

/RA: low: high 

where /RA is the range switch, and low and high define the limits 
required (each being valid octal word-bound addresses) . The saved 
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image will be preceded by the same communication information as 
that for the original program loaded, except that any information 
about the resident EMT modules will be lost. 

The SAVE processor will endeavor to get an extra 256-word 
buffer in order to satisfy the command. If this request cannot 
be granted because of insufficient free core, the command will 
be rejected. The user is therefore advised to use this facility 
only after he has released any datasets currently established. 

Once the SAVE command has been syntactically verified, any 
errors will be handled by the SAVE processor, which will print 
a relevant message and return to Monitor listening mode: 

DEVICE FULL End of output medium reached 

FILE ERROR XXX File structures error as indi- 
cated by XXX = file status byte 
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STOP 



2.8.18 The STOP Command 



Format: 



ST [OP] 

Purpose; 

This is an emergency command to stop the program and to 
abort any I/O in progress (by doing a hardware reset) . The pro- 
gram may be resumed with either the BEGIN or RESTART command. 

STOP is valid only if a program is in core. 

STOP differs from KILL in that KILL terminates the program 
in an orderly manner and removes the program from core. 
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TIME 



2.8.19 The TIME Command 



Format: 



TI [ME] A [time] 
Purpose ; 

The TIME command may be used to obtain the current time-of- 
day and to enter a time value from the keyboard. The time 
is printed in the following format. 

hh:mm:ss 

meaning hours : minutes : seconds . 

To obtain the current time-of -day, simply type the TIME 
command followed by the RETURN key. For example: 



$_TIME 
10:43:27 



The current time-of-day is entered by the system or installation 
manager, and need not be reentered except when loading a new DOS 
Monitor. 

rpi^ Qi-i-f-Qv- a +■ -irriQ vslue froffl the ke^'board t^'^tse the TIME comm.and 
the desired time value, and then the RETURN key. 
For example: 

£TIME a hh:mm:ss 

putting the desired time value in place of hh:mm:ss. The entered 
time value is returned in response to subsequent TIME commands 
until another time value is given. 

TIME is valid at any time. 
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WAIT 



2.8.20 The WAIT Command 



Format; 



WA[IT] 

Purpose: 

The WAIT command suspends the current program and allows any 
I/O in progress to finish. The program may be resumed with either 
the CONTINUE or RESTART command. 

WAIT is valid only if a program is in core. 
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CHAPTER 3 
PROGRAMMED REQUESTS 



3.1 INTRODUCTION 

The Monitor provides a number of services which are available 
to any user or system program. The most prominent of these are 
input/output (I/O) services. Other services include directory manage- 
ment, retrieval and modification of system parameters, various con- 
version routines, and a command string interpreter. The I/O services 
provide for linkage to device drivers, access to files in the file 
structure, and transfer of data to or from each device. 

The user program calls for the services of the Monitor through 
programmed requests. Frogramined requests are macro calls ^ which are 
assembled into the user program and interpreted by the Monitor at 
execution time. A programmed request consists of a macro call 
followed, when appropriate, by one or more arguments. For example: 

.WAIT #LNKBLK 

is a programmed request called .WAIT followed by an argument #LNKBLK. 
The macro request is expanded at assembly time by the MACRO Assembler^ 
into a sequence of instructions which trap to and pass the arguments 
to the appropriate Monitor service routine to carry out the specified 
function. The assembly language expansion for .WAIT #LNKBLK is: 

MOV #LNKBLK,-(SP) 
EMT 1 

To use the macro call, it is necessary to tell the assembler 
that you want the system definition for the macro. This is accom- 
plished via the .MCALL assembler directive (Macro-11 Assembler Pro- 
grammer's Manual), e.g., 

Mr< 7\ T T T.TK -r m 

. i-i\— r^jjij . H'rt.J. J. 

which must appear in the source prior to the first use of .WAIT. When 
.MCALL is encountered, the MACRO Assembler will get the definition of 
.WAIT from the system macro file (SYSMAC.SML) which is searched for, 
first in the current user's disk area, then under user identification 
code [1,1] . 

The system macros will accept most addressing modes as arguments. 
They will detect and announce potentially troublesome (e.g. X(SP)) 
or unlikely (e.g. SP) modes to protect the user. 



^ Users with less than 12K of core cannot run MACRO and consequently 
must include the assembly language expansion of the programmed re- 
quest in their programs instead of the request itself. 
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All legal addressing modes will appear without alteration in 
the expansion. Since the monitor expects the address of the Link 
Block on top of the stack at .WAIT time, any of the following macro 
calls might be appropriate: 



.WAIT #LNKBLK 
.WAIT R0 

.WAIT POINTR 



ADDRESS OF LNKBLK 

IS IN REGISTER R0 

ADDRESS OF LNKBLK IS 

IN MEMORY LOCATION POINTR 



Refer to the MACRO-11 Assembler Programmer's Manual (Order 
Number DEC-11-OMACA-A-D) for further details. 

The programmed request arguments are parameters or addresses of 
tables which contain the parameters of the request. These tables 
are part of the user program, and are described in detail in 
Figures 3-6 to 3-18. 
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Services which the Monitor makes available to the user through 
programmed requests* can be classified into three groups: 

• requests for input/output and related services 

• requests for directory management services 

• requests for miscellaneous services 

Table 3-1 summarizes the programmed requests available under the 
Monitor. Detailed descriptions of each request can be found in 
the sections cited in Table 3-1. 
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Table 3-1 
Summary of Monitor Requests 



Mnemonic 


Purpose 


Section 


Requests for Input/Output and Related Services j 


3.6.1 


.INIT 


Associates a dataset with a device driver and 




sets up the initial linkage. 




.RLSE 


Removes the linkage between a device driver and 
a dataset, and releases the driver. 


3.6.2 


.OPEN 


Opens a dataset. 


3.6.3 


. CLOSE 


Closes a dataset. 


3.6.4 


• READ 


Transfers data from a device to a user's line 
buffer. 


3.6.5 


.WRITE 


Transfers data from a user's line buffer to a 
device. 


3.6.6 


. RECRD 


Transfers one logical record of a file between 
a device and a user buffer. 


3.6.7 


. BLOCK 


Transfers one physical block of a file between 
device and a Monitor buffer. 


3.6.8 


.TRAN 


Tra^nsfers data between a device and a user 
buffer, independent of any file structure. 


3.6.9 


.WAIT 


Waits for completion of any action on a dataset. 


3.6.10 


.WAITR 


Checks for completion of any action on a dataset, 
and provides a transfer address for a busy return. 


3.6.11 


.SPEC 


Performs special device functions. 


3.6.12 


.STAT 


Obtains device characteristics. 


3.6.13 


Requests f 


or Directory Management Services; 


3.7.1 


•ALLOC 


Allocates a contiguous file. 


.DELET 


Deletes a file. 


3.7.2 


. RENAM 


Renames a file. Changes a protection code. 


3.7.3 


.APPND 


Appends one linked file to another. 


3.7.4 


.LOOK 


Searches the directory for a particular filename 
and returns information about the file. 


3.7.5 


.KEEP 


Protects a file against automatic deletion on 
FINISHing. 


3.7.6 


Requests fc 


>r Miscellaneous Services; 




.RUN 


Loads programs and overlays. 


3.8.1.1 


.EXIT 


Returns control to the Monitor. 


3.8.2.1 



(Continued on next page) 
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Table 3-1 
Summary of Monitor Requests (Cont,) 



Mnemonic 


Purpose 


Section 


.TRAP 


Sets interrupt vector for the TRAP instruction. 


3.8.3.1 


,R3TRT 


Sets the address used by the RESTART command. 


3.8.3.2 


.CORE 


Obtains address of highest word in core memory. 


3.8,4.1 


.MONR 


Obtains address of first word above the 
resident Monitor, 


3.8.4.2 


,MONF 


Obtains address of first word above the 
Monitor's highest allocated free core buffer. 


3.8.4.3 


.DATE 


Obtains the date. 


3.8.4.4 


.TIMS 


Obtains the tim.e of day. 


3,8,4.5 


.CVTDT 


Converts internal date or time to ASCII. 


3.8.4.6 


.GTUIC 


Gets current UIC, 


3.8.4.7 


•SYSDV 


Gets Radix-50 name of the system device. 


3.8.4.8 


.GTPLA 


Gets the current program load address. 


3.8.4.9 j 


.STPLA 


Sets the program low address. 


3.8.4.10| 


.GTCIL 


Gets the base disk address of the CIL. 


3.8.4.11 


.GTSTK 


Gets the current stack base address. 


3.8.4.12 


.STSTK 


Sets the current stack base address. 


3.8.4.13 


. STFPU 


Sets the floating point exception vector. 


3.8.4.14 


.RADPK 


Packs three ASCII characters into one Radix-50 
word. 


3.8.5.1 


.RADUP 


Unpacks one Radix-50 word into three ASCII 
characters. 


3.8.5.2 


.D2BIN 


Converts five decimal ASCII characters into 
one binary word. 


3.8.5,3 


.BIN2D 


Converts one binary word into five decimal 
ASCII characters. 


3,8.5.4 


.02BIN 


Converts six octal ASCII characters into one 
binary word. 


3.8.5.5 


.BIN20 


Converts one binary word into six octal ASCII 
characters. 


3.8.5.6 

! 


.CSIl 


Condenses a command string and checks for 
proper syntax. 


1 

3.8.6.1 


.CSI2 


Interprets one command string dataset specifi- 
cation. 


3.8.6.2 
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3.2.1 Requests for Input/Output and Related Services 

All user I/O is handled by programmed requests, which provide 
three different levels of transfer: 

• READ or WRITE 

• RECORD or BLOCK 

• TRAN 

Each level uses a sequence of requests to complete the transfer. 
Note the distinction between READ/WRITE, RECORD/BLOCK, and TRAN as 
names of transfer levels , and .READ, .WRITE, .RECRD, .BLOCK, and 
.TRAN as specific programmed requests within these levels. 

Requests for I/O related services perform special device 
functions (such as rewinding a tape) and obtain device character- 
istics from device status words. 

Each request related to I/O services is described in Section 3.6, 

3.2.1.1 READ or WRITE Level Requests - Most input and output 
is done at this level. Processing is sequential, in that each read 
or write is applied to the next record or line in the file. Records 
may be in either ASCII or binary mode, and a number of formats are 
handled by the monitor. Records may also be of variable length: 
ASCII records usually contain line terminators while formatted binary 
records contain byte counts. 

READ or WRITE I/O under the Monitor consists of transferring 
the contents of a dataset between a device and a line buffer via a 
buffer in the Monitor (Figure 3-la) . A line buffer is an area set 
up by the user in his program, into which he (or the Monitor) places 
data for output (or input) . The line buffer is usually preceded 
by the line buffer header , in which the user specifies the size and 
location of the line buffer and the mode (format) of the data. 
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USER PROGRAM 



USERS LINE 
BUFFER 



W 



.READ 



.WRITE 

.WRITE 



MONITOR BUFFER 



^=X 



DEVICE 



.READ 



_y 



Figure 3-la The Transfer Path 



.INIT #LNKBLK 
MOV #FILBLK,Rj0 
.OPENI #LNKBLK,Rj0 

^.READ #LNKBLK,#BUFHDR 
.WRITE #LNKBLK 

(Process Data) 




.CLOSE #LNKBLK 
.RLSE #LNKBLK 



LNKBLK 
FILBLK 
BUFHDR 



(entries) 
(entries) 
(entries) 



f 



.0- ■ .\ , (»>' 

, y - ^ - 



FOR OUTPUT, REPLACE .OPENI 

WITH .OPENO 
ADDRESS OF FILBLK IS IN Rjd 

FOR OUTPUT, REPLACE .READ 

WITH .WRITE 
COULD BE REPLACED BY .WAITR 



Tables in User's Program 

Figure 3-lb Sequence of Requests for READ/WRITE 
Figure 3-1 .READ/. WRITE Input/Output Transfers 
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When using READ or WRITE one can specify nine different modes 
of transfer, in two categories: ASCII and Binary. Details are 
presented in Section 3.6.1 and Figure 3-11. 

ASCII Modes: Formatted ASCII Parity - Special 
Formatted ASCII Parity - Normal 
Formatted ASCII Nonparity - Special 
Formatted ASCII Nonparity - Normal 
Unformatted ASCII Parity - Normal 
Unformatted ASCII Nonparity - Normal 

Binary Modes: Formatted Binary - Special 
Formatted Binary - Normal 
Unformatted Binary - Normal 

To implement a READ or WRITE transfer, the programmer follows 
the sequence of requests shown in Figure 3-lb. First, the 
programmer associates the device with the dataset via the . INIT 
request. The argument of this request is the address of a table 
called the Link Block. Entries in this table specify the device 
involved in the approaching transfer so that the Monitor may 
eventually establish a link between that device and the dataset. 
The Link Block is described in detail in Figure 3-6. The .INIT 
request loads the appropriate device driver into the Monitor's 
free core area, if it is not already there. 

Following the .INIT request, the programmer opens a dataset with 
an .OPENx request. This need be done only if the device being used 
is a file-structured device. However, it is advisable to use an 
.OPENx even for a non-file-structured device to preserve the device 
independence of the program, since it may be desirable to assign 
the transfer to a file-structured device later. The arguments of 
this request are the address of the Link Block and a register into 
which the user has moved the address of a table called the Filename 
Block (Figure 3-7). Entries in this table describe the file 
involved in the transfer. 

A dataset can be opened for input, for output, for update, or 
for extension. The last letter of the .OPENx request specifies 
which type of open is desired. 

A .READ (for input) or a .WRITE (for output) follows the .OPENx. 
Either request causes a transfer to take place between the line 
buffer and the device via a buffer allocated by the Monitor in 
its free core area. The arguments of either request are the address 
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of the Link Block for the dataset and the address of the Line Buffer 
Header (Figure 3.9). The Line Buffer Header specifies the area 
in the user's core area to or from which the data is to be trans- 
ferred. During the transfer, the Monitor formats the data according 
to the transfer mode and formatting characters in the data itself. 
In most modes, terminating characters indicate the end of a line. 

-READ nr «WRITE i r follov/ed bv .WAIT- v-'hich tests for the 
completion of the last transfer, and passes control to the next 
instruction when the transfer is complete. Typically, what follows 
a .WAIT on an input is a subroutine to process the portion of data 
just read. When the process has been completed, the program checks 
to see if there is more data; if there is, the program transfers 
control back to the .READ request and the process is repeated. If 

CLJ.J. ci.ciL.ci licis uccii i-j. ciiio J- CJ- i cu. , uiic .v^j-iwOiJ j.cv^u.coL- J- w J. a.\j w ta uw 

complete any pending action, update any directories affected, and 
release to free core any buffer space the Monitor has allocated from 
free core for this dataset. Finally, action on the dataset is 
formally terminated with the .RLSE request, which disassociates the 
device from the dataset, and releases the driver. Releasing the 
driver frees core provided there is no other claim to the driver 
from another dataset. 
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3.2.1.2 RECORD Level Requests - The Record Level request is 
used for random access to the records in a file. A program which 
uses Read or Write Level requests can only read or write the next 
record in the dataset being processed. When Record Level requests 
are used, the program always has access to any record in the file. 

Record Level requests may be used only with file-structured 
devices and only with contiguous files (not with linked files). 
Each of the records in the file must contain the same numbers of 
bytes. No formatting is done and no line terminating characters 
are needed. The length of a record is independent of the block 
size of the device (may be the same or smaller or larger; neither 
record length nor block size need divide the other, but processing 
may be faster if this is arranged, since it can reduce the number 
of multi-block transfers) . 

Some consideration must be given to the manner in which a 

Record Level file is created. Perhaps the most common way to create 

such a file is by doing an .OPENC (after the file has been allocated) 

and using the .WRITE request to enter data. Unformatted ASCII and 
unformatted binary are the suggested transfer modes, since they 

do not require terminators and do not perform formatting; recall 
that all records must be the same length. When such a file is 
.CLOSED, a logical end -of -file is established following the last 
record written. Subsequent processing of the file by .READ 
or .RECRD will be confined to the area just written. At some 
later time, the file may be opened for extension (.OPENE) and more 
data can be written (.WRITE), provided the original space allocated 
to the file is sufficient to contain it. A second way to create a 
Record Level file is to start with .OPENU (again the file must have 
been allocated previously) and to use .RECRD to do the writing. In 
this mode, the logical end-of-file corresponds to the end of the 
allocated area) . Note also that, unless the program writes in every 
record of the file, that some records will be left with meaningless 
contents. 

Before issuing Record Level requests, the program must issue 
an .INIT request to associate the dataset with a file-structured 
device. It must then open the dataset; .OPEN is not optional as 
with .READ and .WRITE. The dataset may be opened in two ways: 
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USER PROGRAM 



USER BUFFER 



.RE CR D output 



.RECRD i nput 



1 



DEVICE 



Figure 3-2a The Transfer Path 



Request next 
record for 
update if 
more 



.INIT 
MOV 



#LNKBLK 
#FILBLK,R1 



. OP ENU # LN KBLK , R 1 

->. RECRD #LNKBLK,#RECBLK 

.WAIT #LNKBLK 

I 
(Process Data) 

I 

.RECRD #LNKBLK,#RECBLK 

.WAIT #LNKBLK 




LNKBLK; 
FILBLK 

-OTPf-DT V . 



;INIT THE DATASET 



;OPEN THE FILE 

; INPUT THE RECORD 



; OUTPUT THE RECORD 



CLOSE # LNKBLK 
RLSE # LNKBLK 



Tables in User Program 



; CLOSE THE FILE 

; RELEASE THE DATASET 



■•; 



Figure 3-2b Sequence of Requests for .RECRD 



Figure 3-2 .RECRD Input/Output Transfers. 
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• OPENU - This mode is used if the program will write 

in the dataset. Reading is also permitted. 
In fact, quite often the program will read a 
record, update it, and write it back. 

• OPENI - This mode is used if no writing will be done. 

Only reading will be permitted. 

The dataset may then be processed using .RECRD requests. If 
updating is being done, there will generally be two such requests 
in each cycle. Otherwise, there will be only one. Each .RECRD 
request should be followed by a .WAIT (or .WAITR) request. When 
processing is completed, a .CLOSE request should be issued to 
ensure that the last record is actually written to the device (for 
output) and that the directory is updated (if necessary). A .RLSE 
request is also required, so that the driver can be removed from 
core (if not still in use by another dataset) . The .RECRD request 
has a Link Block and a Record Block as arguments. The Record 
Block specifies function (input/output), buffer address, record 
length, and record number (see Figure 3-12) . 

3.2.1.3. BLOCK Level Requests - The Block Level request is 
used for random access to the physical blocks in a file. The 
Block Level is similar to the Record Level. However, at the 
Block Level, each request always reads or writes exactly one 
physical block of data instead of a user-defined quantity of data, 
as is true at the Record Level. In addition, data transfer is to 
and from a buffer provided by the monitor, rather than a buffer 
provided by the user. The user may do his processing in the 
monitor buffer or he may transfer data to his own area. As with 
Record Level requests. Block Level requests may be used only with 
file-structured devices and only with linked files (ae-t-jiiii-fcfe' 
contiguous files) . 

To implement a BLOCK transfer, the programmer follows the 
sequence of requests shown in Figure 3-3b. Notice that the transfer 
must use .INIT, .OPEN, .WAIT, .CLOSE and .RLSE following the same 
rules as the READ or WRITE level. The .BLOCK request has the 
address of the Link Block and the BLOCK block for its arguments. 

The BLOCK block specifies the function (INPUT, GET, or OUTPUT) , 
the relative number of the block being transferred to or from, the 
Monitor buffer address (supplied by the Monitor), and the length of 
the Monitor buffer (supplied by the Monitor). See section 3.6.8. 
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POSSIBLE 
USER BUFFER 



~7K 

I * 



Monitor ' s buffer and the 
user's buffer are optional 
and must be done by the 
user. 



MONITOR BUFFER}^ 



BLOCK OUTPUT 



'.BLOCK INPUT 



X 



r'igure 3- 3a The Transfer Path 



DEVICE 



.IN IT #LNKBLK 

MOV #FILBLK,R1 

.OPENU #LNKBLK,R1 

->. BLOCK #LNKBLK,#BLKBLK 

.WAIT #LNKBLK 



; INPUT DESIRED BLOCK 

; COULD BE REPLACED BY .WAITR 



"es 



(Process Data) 

.BLOCK #LNKBLK,#BLKBLK 
.WAIT #LNKBLK 




; UPDATE DATA 

; WRITE UPDATED BLOCK 



.CLOSE #LNKBLK 

.RLSE #LNKBLK 

LNKBLK: (entries) 

FILBLK: (entries) 

BLKBLK: (entries) 

Figure 3-3b The Sequence of Requests For .BLOCK 
Figure 3-3 .BLOCK Input/Output Transfers 
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3.2.1.4 T RAN Level Requests - A TRAN level request is a basic 
input/output operation. No services are provided for the user other 
than to pass his request to the appropriate driver. .TRAN ignores 
any file-structure on the device. .TRAN does not operate within a 
particular file as do .READ, .WRITE, .RECRD, and .BLOCK; hence no 
.OPEN or .CLOSE is used. Because .TRAN does not respect file 
structures, the user is strongly cautioned against using it with 
file-structured devices, since he can easily do irreparable damage 
to information on such a device. Omitting the dataset name from the 
Link Block will prevent a file-structured device from being assigned. 

Data is transferred directly between the device and a buffer 
provided by the user (Figure 3-4a), with no formatting performed. 

.TRAN is generally used in 2 situations: 

1. When the file structure does not allow the desired 
operation (e.g. , PIP uses .TRAN to read a directory 

block for the directory listing operation) . 

2. When one does not need or cannot afford the over- 
head of doing READ/WRITE processing on a non-file 
structured device (e.g, a program to read data 
arriving at random intervals from an A/D converter 
might use .TRAN to read the data and .BLOCK to 
buffer the data on a disk for processing as time 
permits. 

To implement a TRAN transfer, the programmer follows the sequence 

of requests shown in Figure 3-4b. Notice that the transfer must 

use .INIT and .RLSE, but must not use .OPEN or .CLOSE. The .TRAN 

request has the address of the TRAN Control Block (TRNBLK) as its 

argument. This block contains entries which specify the core 

starting address of the user's buffer, the device block address, 

the number of words to be transferred, and the function to be 

performed. TRAN is therefore a device dependent request. 

Table 3-2 

Transfer Levels for Types of Datasets 





Type 


of Data 




Type of 


Linked 


Contiguous 


Nonf ile-Structured 


Transfer 


File 


File 


Device 


READ /WRITE 


Yes 


Yes 


Yes 


RECORD 


No 


Yes 


No 


BLOCK 


No 


Yes 


No 


TRAN 


* 


* 


Yes 



* indicates that TRAN may be used on a file-structured 
device if the warnings mentioned are observed. Usage 
in these cases is not advised. 
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USER PROGRAM 



USER BUFFER 



.TR_AN output 



j<- 



.TRAN input 



( n-pwT 






Figure 3-4a The Transfer Path 



IN IT #LNKBLK 



^ *■>-'**■< 



-> .TRAN #LNKBLK,#TRNBLK 
.WAIT #LNKBLK 
(Process Data) 



Yes^ 




No 
.RLSE #LNKBLK 

LNKBLK: 

TRNBLK: 



(entries) 
(entries) 



; COULD BE REPLACED BY .WAITR 



Tables and parameters 
in User Program 



Figure 3-4b The Sequence of Requests For .TRAN 



Figure 3-4 .TRAN Input/Output Transfers 
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3.2.2 Requests for Dj/rectory Management Services 

Directory management requests are used to enter filenames into 
directories, search for files, update filenames, and protect files 
against deletion. 

Each directory management request is described in Section 3,7. 

3.2.3 Requests for Miscellaneous Services 
Requests for miscellaneous services include: 

• Requests to Load programs and overlays. 

• Requests to return control from a running program to 
the Monitor. 

• Requests to set Monitor param.eters such as the TRAP 
vector or a program's restart address. 

• Requests to obtain Monitor parameters such as the size 
of the Monitor, the date, the time, and the current 
user's UIC. 

• Requests to perform conversions between ASCII and 
Radix-50 packed ASCII, binary and ASCII decimal, and 
binary and ASCII octal. 

• Requests to access the Command String Interpreter. 
Each miscellaneous service request is described in Section 3.8. 

3.3 DEVICE INDEPENDENCE 

It is generally preferable to write programs so that each 
dataset may be associated with the widest possible variety of 
devices. This makes it easier to move a program from one configura- 
tion to another. It also makes it possible to use the program with 
a variety of different media. For example, the Assembler accepts 
input from disk, paper tape, DECtape, and other devices. 

The monitor makes it relatively easy to achieve this objective. 
Most I/O operations are completely device independent (i.e., no 
special actions by the user are required to accommodate the opera- 
tion to the device, specifically .READ, .WRITE, .OPEN, .CLOSE, 
.WAIT, .WAITR, .INIT, and .RLSE. In addition, .RECRD and .BLOCK re- 
quire only that the device be file structured. Only .TRAN and .SPEC 
are typically device dependent. 

In all cases, no device is associated with a dataset until an 
.INIT request is made. The device name may be specified in any 
of the following ways: 

• the programmer may specify the name in his Link Block? 

• the program can obtain a device name by requesting the 
user to enter a command string (section 3.8.6); this will 
override any device specified in the Link Block; 
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• the user can use the ASSIGN command (see Chapter 2) 
to associate a device (and file name) with the data- 
set, this option overrides both preceding options. 

Note that when a command string is solicited by the program, it will 
always override the link block specification, no matter what is 
entered. However, when ASSIGN is not solicited but is entered 
at the operator's discretion, it will override the Link Block 
only when specified. In the latter case, it is best to supply 
a default in the Link Block. 

Note that the substituted devices must be compatible. For 
example, the user may initially specify a BLOCK transfer from disk 
and later change the assignment to input from DECtape instead. 
But, he cannot later specify a paper tape reader as the input 
device, since BLOCK level requests do not apply to nonfile- 
structured devices. 

It is important to note that a device is assigned in a program 
to a dataset logical name and that reassigning a device at run 
time for one dataset logical name does not reassign that device 
for all dataset logical names to which it was originally assigned. 

The only transfer requests which are not device independent 
are .TRAN and .SPEC. 

3. 4 SWAPPING ROUTINES INTO CORE 

Except for a small, permanently resident portion, the Monitor 
routines which process most programmed requests are potentially 
swappable. They are normally disk resident and are swapped into 
core by the Monitor only when needed. The user may, however, 
specify that one or more of these potentially swappable routines 
be made permanently core resident or core resident only for the 
duration of his program's run. 

Making a potentially swappable routine core resident ties up 
core space, but speeds up operation on the associated request. The 
user may, for example, be collecting data via a .TRAN request in a 
real-time environment. In such a case, even the short time needed 
to swap in the .TRAN request processor could cause him to lose data. 

Any routine which services a programmed request (other than 

.READ or .WRITE) may be made core resident by one of the following 

methods : 

• Routines may be made permanently core resident at 
Monitor Generation time (see the DOS System 
Manager's Guide). 
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• Routines may be made core resident for the duration 
of a program's run by declaring the appropriate 
global name (as specified in the definition of each 
request in Sections 3.6 through 3.8) in a .GLOBL 
assembler directive in the user program. For example, 
to make the .TPJ^I processor resident while program 
FROP is being run, the following directive would be 
included in program FROP: 

.GLOBL TRA 

Device drivers are swapped into the Monitor's free core area 
on an . INIT call and are freed from core on the occurrence of a 
.RLSE, provided no other dataset is INITed to that device. 

3.5 MONITOR RESTRICTIONS ON THE PROGRAMMER 

In return for the services provided by the Monitor, the 
programmer must honor certain restrictions: 

• The programmer should not use either the EMT or the 
lOT instructions for communication within his program. 

• It is recommended that the user not raise his 
interrupt priority level above 3, since it might 
lock out a device that is currently trying to do 
input/output . 

• HALTS are not recommended. If a HALT is executed 
during an I/O operation, most devices will stop, 
and only recovery from the console (pressing the 
CONTinue switch on the console) will be effective 
(recovery from the keyboard will not be immediately 
possible, since a HALT inhibits the keyboard 
interrupt). Some devices, such as DECtape, will not 
see the HALT and will continue moving, will lose 
their positions over the block under transfer, and 
may even run the tape off the reel. 

• The RESET instruction should not be used because it 
forces a hardware reset; clearing all buffer registers, 
and status flags and disabling all interrupts, includ- 
ing keyboard interrupts. Since all I/O is interrupt 
driven, RESET will disable the system. 

• The user must not penetrate the Monitor when he is 
using the stack. The stack is set by the RUN time 
loader just below the lowest address of the program 
loaded. The Monitor checks to see that the stack is 
not overflowing each time it honors a request. 

• The user may allocate temporary storage areas on 
the stack by simply subtracting the size of the 
area needed from the current stack pointer value. 

When doing so, he should use a .MONF (Section 3 .8 .4 . 3) to 
determine the highest address being used by the 
Monitor. It is generally wise to leave some space 
for future Monitor expansion (as a consequence of 
programmed requests) and for stack extension (as a 
consequence of subroutine calls. Monitor requests, 
device interrupts, etc.). Consult Figure 3-5 for 
more information about monitor core usage. 
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• The user should be aware that certain requests, 
such as .INIT, may change the amount of available 
free core, since the instructions may call in drivers 
and establish data blocks. Such requests affect the 
result of MONF requests. 

• Certain requests return data to the user on the stack. 
The user must clear the stack himself before the 
stack is used again. The Monitor clears the stack 
after it honors requests that do not return data to 
the user on the stack. 

• The user should not use global names that are 
listed in Appendix E. 

• The Link pointer in the Link Block is set by the 
Monitor and must not be altered by the user. 
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.INIT 

3. 6 REQUEST FOR INPUT/OUTPUT SERVICES 

3.6.1 . INIT - Associate a dataset with a device driver and set up 
the initial linkage. 

Macro Call : .INIT #LNKBLK 

where LNKBLK is the address of the Link Block. 

Assembly Language Expansion : 

MOV # LNKBLK, -(SP) 
EMT 6 

-^ Global Name : INR 

Description : Assigns a device to a dataset and assures that the 
appropriate driver exists and is in core. If the driver is not in 
core, it is loaded. The device assigned is that specified in the 
associated Link Block, unless assignment has been made to the logical 
name specified in the Link Block with the ASSIGN command or via the 
Command String Interpreter. After the .INIT has been completed, 
control is returned to the user at the instruction following the 
assembly language expansion. The argument is removed from the stack. 

Rules : The user must set up within his program a Link Block 

of the format explained in section 3.9.1 for each dataset to be 
INITed. A dataset which has been . INITed should be .RLSEd prior to 
any further .INIT request for any Link Block. 

Errors: A nonfatal error message, A003, is printed on the 
teleprinter if no assignment has been made through the ASSIGN command, 
and the DEFAULT DEVICE is either not specified in the Link Block or 
has been specified illegally (i.e., no such device on the system). 
The user may type in an assignment (ASSIGN) and give the CONTINUE 
console command to resume operation. 

Control is transferred to the address specified by the error 
return address in the Link Block if at any time during an operation 
there is not enough space in free core for the necessary drivers, 
buffers, or tables. If no address (i.e., a zero) is specified in the 
Link Block's ERROR RETURN ADDRESS, a fatal (F007) error is printed 
and the program stops. 

Example: (see .RLSE) . 
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.RLSE 

3.6.2 .RLSE - Remove the linkage between a device driver and a data- 
set and release the driver. 



Macro Call: 



.RLSE #LNKBLK 



where LNKBLK is the address of the Link Block previously INITed. 

Assembly Language Expansion : 

MOV #LNKBLK,-(SP) 
EMT 7 



Global Name: 



RLS 



Description : Dissociates the device from the dataset and releases 
the dataset 's claim to the driver. Releasing the driver frees core 
provided no other dataset has claimed the driver, and provided that 
the driver is not oermanentlv core resident. 



Rules 



The device to be released must have been previously 



INITed to the dataset. 

If the dataset has been OPENed on a directory device, it must be 
CLOSEd before the device is released. On a nondirectory device, a 
•RLSE will ensure that any data remaining in the Monitor buffer for 
output is dispatched to the device and will return any buffer still 
associated with the dataset to free core. 

After the release has been completed, control is returned to the 
user at the instruction following the assembly language expansion; 
the argument is removed from the stack. 



Errors: 



If the dataset has been OPENed to a file-structured 



device, a .RLSE not preceded by a .CLOSE will be treated as a fatal 
error, F005. A .RLSE error (F005) may also occur if the link pointer 
in the Link Block is invalid, indicating probable corruption of the 
Monitor or its control blocks. 



Example: 



. INIT #LNK1 



; ASSOCIATE A DATASET WITH A DEVICE 



.RLSE #LNK1 



LNKl; 



WORD 


ERRl 


WORD 





RAD50 


/DSI/ 


BYTE 


1,0 


RAD50 


/KB/ 



ERROR RETURN ADDRESS 
POINTER FOR MONITOR 
LOGICAL NAME OF DATASET 
DEVICE SPECIFIED, UNIT 
SPECIFY KEYBOARD 



ERRl 



; ERROR PROCESSING LOGIC 
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.OPEN 

3.6.3 .OPEN - Prepare a device (which has been .INITed) for data 
transfer and associate the dataset with a file (if the device is file- 
structured ) . 

Macro Call : .OPEN #LNKBLK,#FILBLK 

This form assumes that the File Block contains a code indicating how 

the file is to be opened (see Description below) . 

Assembly Language Expansion : 

MOV #FILBLK,-(SP) 
MOV #LNKBLK,-(SP) 
EMT 16 

Alternate Form of Macro Call : 

.OPENx #LNKBLK,Rn 
where Rn is a register containing the address of the File Block and 
X indicates the type of .OPEN (see Description below) . 

Assembly Language Expansion : 

MOVE #C0DE,-2(Rn) (see Description below) 

MOV Rn,-(SP) 

MOV #LNKBLK,-(SP) 

EMT 16 

Global Name : OPN (See Appendix C for subsidiary routines.) 

Description : When used, .OPEN follows .INIT or .CLOSE (if more than 
one file is to be opened on the same dataset) . When the device being 
used is file-structured, .OPEN associates a specific file with the 
dataset. .OPEN also acquires a data buffer and prepares the device 
or the file for the ensuing data transfers. See Appendix C for details 
about specific .OPEN actions for particular devices. .OPEN has five 
forms; the desired form may be specified by inserting the proper 
HOW OPEN code in the File Block (see Figure 3-7) or by selecting one 
of the alternate forms of the Macro Call. The different .OPEN forms 
are described below: 

HOW OPEN 
Form Code Description 

.OPENU 1 opens a previously created contiguous file 

for input and output by .RECRD or .BLOCK 
request; .OPENU is rejected if the device 
is not file-structured. 

.OPENO 2 a. creates a new linked file and prepares 

it for output via .WRITE; the file 
must not already exist. 
b. prepares a nonf ile-structured device 

for output via .WRITE (see Appendix C) . 
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.OPEN (cont) 
HOW OPEN 
Form Code Description 

.OPENE 3 opens a previously created linked or con- 

tiguous file to make it longer via .WRITE; 
note that a contiguous file may only be 
extended within the area already allocated; 
although additional blocks may be added to 
a linked file, no additional blocks may be 
added to a contiguous file (see .CLOSE) ; 

is not file-structured. 

.OPENI 4 a. opens a previously created linked or 

contiguous file for input via .READ, 
.RECRD, or .BLOCK, 
b. prepares a nonf ile-structured device 
for input via .READ (see Appendix C) . 

.OPENC 13 opens a previously created contiguous file 

for output via .WRITE; when a contiguous 
file is first opened for writing (via 
.WRITE), .OPENC must be used; subsequent 
opens for output (via .WRITE) must be 
.OPENE' s; .OPENC is treated like .OPENO 
if the device is not file-structured. 

At this point, the user should note the difference between linked 
files and contiguous files. A linked file has records allocated to it 
one at a time, as they are needed. Each record in the file contains 
a pointer to its successor, the User File Directory (UFD) points to 
the first record. Because records are allocated as needed, the user 
need not concern himself at all with the size of the file nor with the 
allocation of any records. Furthermore, a linked file can easily be 
extended in the future. However, because records are scattered about 
on the disk and because the system must read all intermediate records 
to move from one record to another (forward only) , linked files can 
only be used for sequential processing (.READ or .WRITE). 

A contiguous file has all of its records allocated at once in a 
contiguous area of the disk which is reserved for the file. Since any 
record in the file can easily be located relative to the first record 
in the file, random (or direct) access (.RECRD or .BLOCK) is possible 
in addition to sequential access. However, it is now necessary to 
know in advance how much space will be needed, since no more space can 
be added later. Since this may be difficult, one often has to guess 
and space is often wasted. Note, however, that a contiguous file can 
be extended within the space already allocated, i.e., if the area was 
not filled when the file was first written (or extended) , more data 
can be added. Because the user is responsible for determining the 
size of a contiguous file, he is required to allocate it before open- 
ing it (compare .OPENC and .OPENO). This may be done with PIP, using 
the ALLOCATE command or with the .ALLOC programmed request. 
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.OPEN (cont) 

After the open request has been processed, control is returned to 
the user at the instruction following the assembly language expansion; 
the arguments are removed from the stack. At this time, however, the 
device concerned may still be completing operations required by the 
request. A summary of transfer requests which may legally follow 
.OPEN requests is illustrated in Table 3-3. 

Table 3-3 
Transfer Requests Which May Follow Open Requests 





















Linked File 


Contiguous File 






Input 


Output 


Input 


Output 


File 
Already 
Exist ? 


Type of ^'*C^t 
Open '" 


.READ 


. WRITE 


.READ 


.RECRD 
. BLOCK 


.WRITE 


. RECRD 
.BLOCK 


. OPENU 








Yes 




Yes 


Must 


. OPENO 




Yes 










Must Not 


.OPENE 




Yes 










Must 


.OPEN I 


Yes 




Yes 


Yes 






Must 


. OPENC 










Yes 




Must 



Rules : a. General Rules for All .OPENx Requests - The user must 
set up a Filename Block in his program (see Figure 3-7) . If the 
dataset is a file, the Filename Block must contain a legal file- 
name (see Section 2.3). If the dataset is not a file, or if it 
will be specified by an .ASsign or via the Command String 
Interpreter, the Filename Block need not contain any FILENAME or 
EXTENSION entries. 

All dataset s must have been INITed before they are OPENed. 
The .OPEN must be applicable to the type of device (e.g., .OPENI 
to the line printer is illegal) . 

For datasets on directory devices, the User Identification 
Code (UIC) in the Filename Block (if specified) must be in the 
directory of the device. If the UIC is not specified, the user 
must have logged in with a UIC that appears on the device. 

The .OPENx request must not violate the protect code of the 
file. 

If a dataset is opened for any output, it cannot be opened 
again until it has been closed. 
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.OPEN (cont) 

b. Rules for .OPENO - The .OPENO request is applicable 
only for outputs to nonf ile-structured devices or to a linked 
file on a file-structured device. It is not applicable to con- 
tiguous files. 

The .OPENO request creates a linked file on a directory device; 

cannot exist prior to the .OPENO request. 

The .OPENO request will return an error if the disk is 
full. 

c. Rules for .OPENI - .OPENI may be used for inputs from 
contiguous or linked files, or nondirectory devices. 

The file referenced in the corresponding Filename Block must 
exist in the directory. 

If a file is open for input (.OPENI), it cannot be opened for 
output, but it may be opened for extension or update. 

At any one time, a file can be opened for input to a maximum 
of 62,^ or 76o datasets. 

X u o 

^' Rules fo r .OPENU, OPENE, and .OPENC - The file must 
exist and cannot currently be opened for output. 

The file cannot currently be opened by another .OPENU, .OPENE, 
or . OPENC . 

A contiguous file can be opened for extension, provided that 
the area already allocated to the file does not need to be en- 
larged, which is not possible. 

A linked file cannot be opened with .OPENC, which is appli- 
cable only to contiguous files. 

Errors : If any of the preceding rules are violated, the Monitor 
places an error code in the STATUS byte of the Filename Block (see 
Table 3-7) and transfers control via the pointer in the ERROR RETURN 
ADDRESS of the Filename Block. If this address is 0, a fatal error 
message is printed on the teleprinter. Fatal error messages are 
listed in Appendix F. 

Example; (See .CLOSE) 
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.CLOSE 

3.6.4 . CLOSE - Close a dataset. 

Macro Call : .CLOSE #LNKBLK 

where LNKBLK is the address of the Link Block (see Figure 3-7) . 

Assembly Language Expansion : 

MOV #LNKBLK,-(SP) 
EMT 17 

Global Name : CLS (See Appendix C for subsidiary routines.) 

Description : The ^CLOSE request indicates to the Monitor that no 
more I/O requests will be made on the dataset. .CLOSE completes any 
outstanding processing on the dataset (e.g., on output, it writes the 
last buffer; on extension, it links the extension to the old file; 
etc.), updates any directories affected by the processing, and re- 
leases to free core any buffer space established for the processing. 
When a file which has been opened for output is closed, the last block 
written and the last byte written are recorded in the directory to 
indicate end-of-data. This eliminates the need to pad out blocks with 
nulls and allows the written data within a contiguous file to be 
extended at a later time. 

After the .CLOSE request has been completed, control is returned 
to the user at the instruction following the assembly language expan- 
sion; the argument is removed from the stack. As with .OPEN, some 
appropriate device action may still be in progress at this point (see 
Appendix C) . 

Rules : The dataset to be closed must have previously been 
opened if it was a file on a file-structured device. 

As with .OPENx, a .CLOSE is not required if the dataset is not 
a file, but it is strongly recommended in order to maintain device 
independence . 

Errors : Dataset Not Inited - Fatal Error FOOO; 
Device Parity Error - Fatal Error F017 
All error messages are explained in Appendix F. 
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Example : Open for input a dataset named IMP, which is file 
PR0G1.BIN on DECtape unit 3. After the data transfer is complete, 
close the file. 



.INIT #SET1 

.OPEN #SET1,#FILE1 ; OPEN SETl FOR INPUT (OPEN CODE 
: ;IS IN FILE BLOCK) 

(Input is 
Performed 
Here) 



.CLOSE #SET1 



rT.n.c^F. .qRTi 



,RLSE #SET1 



SETl: 



.WORD ERRl 
, WORD 
, RAD 50 /IMP/ 
, BYTE 1 , 3 
, RAD 50 /DT/ 



; DATASET NiLME 

; PHYSICAL DEVICE NAME 



.WORD ERFl 

. WORD 4 

FILEl: .RAD50 /PRO/ 

.RAD50 /Gl/ 

.RAD 50 /BIN 
.BYTE PROG, PRO J 
.BYTE 177 
.EVEN 



ADDR OF ERROR RTN 
OPEN FOR INPUT 

F ILENAME 

; EXTENSION 



ERRl; 



;HERE FOR .INIT, .OPENI, .CLOSE, 
;0R .RLSE ERRORS (DEVICE) 



ERFl: 



;HERE FOR .OPENI ERRORS 
; (DATA FILE) 
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.READ 

3.6.5 . READ - Read the next record in the dataset. 

Macro Cal l: .READ #LNKBLK, #BUFHDR 

where LNKBLK is the address of the Link Block, end BUFHDR is the ad- 
dress of the line buffer header. 

Assembly Language Expansion : 

MOV #BUFHDR,-(SP) 
MOV #LNKBLK,-(SP) 
EMT 4 

Global Name : RWN (Routine is permanently core resident) . 

Description : The .READ request transfers the data from the device to 
the user's line buffer as specified in the line buffer header. The 
transfer is done via a buffer in the Monitor, into which an entire 
device block is read, and from which the desired data is transferred 
to the user's line buffer. Each read causes the user to receive the 
next record in the data set. Block boundaries are ignored and new 
blocks are read as needed. After any I/O transfer has been started, 
control is returned to the user at the next instruction, with the argu- 
ments removed from the stack. 

Refer to Section 3,9.3.2 for more details on transfer modes. 

Rules: If the device is file structured, the .READ request 
must be preceded by an .OPENI. The user must provide in his pro- 
gram a line buffer and line buffer header (see Figure 3-9). Further 
actions on the dataset by the Monitor will be automatically postponed 
until the .READ processing has completed. The user program should, 
however, perform a .WAIT or .WAITR to ensure proper completion of trans- 
fer before attempting to use the data in the line buffer. Otherwise, 
he might find that he is processing before the data he wants has ar- 
rived. 

Errors : Specification of a transfer mode which is inappropriate 
for the device assigned to the dataset, attempting to .READ from or 
.WRITE to a file-structured device for which no file has been .OPENed 
or for which the type of .OPEN is incorrect will be treated as fatal 
errors and will result in a FOlO message. 

Note: A dataset can only support transfers in one direction at 

one time, i.e., READ only or WRITE only. If the same device is to be 
used for both operations, spearate datasets must be used for each. 
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.WRITE 

3.6.6 . WRITE - Write the next record in the dataset. 

Macro Call : .WRITE #LNKBLK,#BUFHDR 

where LNKBLK is the address of the Link Block, and BUFHDR is the ad- 
dress of the line buffer header. 

Assembly Language Expansion : 

MOV # BUFHDR, -(SP) 
MOV # LNKBLK,- (SP) 
EMT 2 

G lobal Name : RWN (Routine is permanently core resident) . 

Description : The .WRITE request initiates the transfer of data from 
the user's line buffer to the device assigned. The data is first 
transferred to a buffer in the Monitor, where it is accumulated until 
a buffer of suitable length for the device is filled. ^ The data in the 
Monitor buffer is then transferred to the next device block, and any 
data remaining in the user's line buffer is moved to the (now emptied) 
Monitor buffer. After any I/O transfer to the device has been started, 
control is returned to the user at the next sequential instruction. 
The arguments are removed from the stack upon return. 

Refer to Section 3.9.3.2 for more details on transfer modes 
and the like. 

Rules: If the requested device is file structured, the dataset 
must have been opened by an .OPENO or .OPENE for a linked file, or 
.OPENC for a contiguous file. The user must provide a line buffer and 
its header in his program (Figure 3-9). 

Further actions on the dataset by the Monitor after .WRITE will 
be automatically postponed until the .WRITE processing has been com- 
pleted. Before refilling the line buffer, however, the user program 
should perform a .WAIT or .WAITR to ensure proper completion of the 
transfer. Otherwise, it might store new data on top of data which has 
not yet been written. 

Errors: See .READ for errors. 



^For terminal devices, data transfer also occurs when a line 
terminator is seen (see Section 3.9.3.2). 
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.RECRD 

3.6.7 .RECRD - Read or write a specific record in a file. 

Macro Call ; .RECRD #LNKBLK,#RECBLK 

where LNKBLK is the address of the Link Block, and RECBLK is the 

address of the Record Block (see Figure 3-12) . 

Assembly Language Expansion : 

MOV # RECBLK,- (SP) 
MOV #LNKBLK,-(SP) 
EMT 25 

Global Name : REC 

Description : The .RECRD request causes a specific record to be 
transferred to (or from) the user's record buffer. Each record in 
the file may be individually addressed, and the user is not restricted 
to reading or writing the next record. Data transfer is by way of a 
buffer in the Monitor which will contain exactly one physical block 
of information. There is no rule concerning the relative sizes of 
records and blocks; however, efficiency may be improved if one is a 
multiple of the other. The Record Block specifies record number 
(starting at J0) , buffer address and length, and transfer direction 
(read or write). .RECRD requests require the use of the .INIT, .RLSE, 
.OPEN, .CLOSE, and .WAIT (or .WAITR) requests. After the transfer 
has started, control is returned to the user at the instruction 
following the assembly language expansion with arguments removed from 
the stack. 

Rules: The requested device must be file-structured and the 
file must be contiguous. 

The user must set up a Record Block in his program and must pro- 
vide a buffer. 

All records must have the same length. 

The user should perform a .WAIT or .WAITR to ensure that proces- 
sing has completed. 

The associated file must have been opened with .OPENU or .OPENI. 

Errors : An error causes a return to the user with the type 
of error indicated in the FUNCTION /STATUS word of the RECORD BLOCK. 
The user should perform the following test after his request to ensure 
that the request completed normally. 

TSTB RECBLK+1 

BNE ERROR 
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.BLOCK 

3.6.8 . BLOCK - Read or write a specific block in a file. 

Macro Call ; .BLOCK #LNKBLK, #BLKBLK 

where LNKBLK is the address of the Link Block, and BLKBLK is the ad- 
dress of the BLOCK block (see Figure 3-13) . 

Assembly Language Expansion : 

MOV #BLKBLK,- (SP) 
MOV #LNKBLK,-(SP) 
EMT 11 

Global Name : BLO 

Description : BLOCK requests provide for random access to the 
blocks of files stored on disk or DECtape. 

In this mode, data is transmitted to or from a specified block 
in a file with no formatting performed. Transfers take place between 
the device block and a Monitor buffer. The user may process the 
data in the Monitor buffer or he may transfer the block to and from 
his own area. BLOCK requests require the use or the -INIT, .OPEN, 
.CLOSE and .WAIT (or .WAITR) requests. 

The user must specify one of three functions in the BLOCK block: 
INPUT, GET, or OUTPUT (see Figure 3-13). After the transfer has 
started, control is returned to the user at the instruction following 
the assembly language expansion with arguments removed from the stack. 

INPUT: During an INPUT request, the requested block of the 

requested file is read into a Monitor buffer, and the 
user is given in the BLOCK block (see Figure 3-11) 
the address of the buffer and the physical length of 
the block transferred. 

GET: During a GET request, the Monitor returns in the BLOCK 
Block the address and length of a buffer within the 
Monitor that he can fill for subsequent output. Only 
one GET is required for each time the file is OPENed 
and CLOSEd (i = e= , once a buffer has been located, it- 
may be used repeatedly) . The user must assure that 
he does not over-run the buffer. This request is un- 
necessary if an INPUT request has occurred. 

OUTPUT: During an OUTPUT request, the contents of the buffer 
assigned is written on the device in the requested 
relative position in the requested file. 

Rules: The associated file must be opened by .OPENI for input 
or .OPENU for input or output. 

^ Access to linked files or nondirectory devices is illegal. 

The user must set up the BLOCK block in his program according to 
the format of Figure 3-13. 
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.BLOCK (cont) 

Errors : Error processing causes a normal return to the user, 
with the type of error indicated in the FUNCTION/STATUS word of the 
BLOCK block. The user should perform 

TSTB BLKBLK+1 

BNE ERROR 
after a .WAIT to assure that his request was error free. 
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.IRAN 

3.6.9 .TRAN - Read or write the specified block (file-structured 
device) or the next block (non-file-structured device) . 

Macro Call: .TRAN #LNKBLK,#TRNBLK 

where LNKBLK is the address of the Link Block, and TRNBLK is the ad- 
dress of the TRAN block (see Figure 3-14) . 

Assembly Language Expansion : 

MOV # TRNBLK,- (SP) 
MOV #LNKBLK,- (SP) 
EMT 10 

Global Name : TRA 

Description : .TRAN provides nearly direct access to the device on 
which the dataset resides. No file processing is done and any file 
structure is ignored. Therefore, writing with .TRAN on a file- 
structured device is especially risky and many lead to the corruption 
of all data on the device. If .BLOCK request can be used instead of 
.TRAN, it is recommended. Each .TRAN will transfer one or more blocks, 
depending upon the wxDrd count in the TRAN Block. Blocks on file- 
structured devices are referenced by absolute block number, while blocks 
on non-file-structured devices are processed in sequence. .INIT, .RLSE 
and .WAIT (or .WAITR) must be used. .OPEN and .CLOSE must not. 
After the transfer has started, control is returned to the user at the 
instruction following the assembly language expansion. The arguments 
are removed from the stack. 

Rules : .TRAN must be preceded by an .INIT request on the as- 

sociated dataset. .OPEN must not be used. For each .TRAN request, 
the user must provide a transfer control block, as shown, in Figure 
3-12. Further actions on the dataset by the Monitor will be automati- 
cally postponed until the .TRAN processing has been completed. The 
user program should perform a .WAIT or .WAITR to ensure proper com- 
pletion of the transfer before attempting to reference any location 
in the data buffer. 

Errors : An invalid function code in the transfer control block 
will result in an error diagnostic message on the teleprinter at run 
time. 

Errors in the transfer will be shown in the FUNCTION/STATUS word 
of the TRAN block; the last word of the block will be set to show 
how many data words have not been transferred. 
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.TRAN (cont) 
Example : Transfer 200o words of data from DECtape unit 3, 

o 

starting at block lOOg to core starting at location BUFFER. 



INIT #TAPE1 



TRAN #TAPE1, #BIN4 



RLSE #TAPE1 



TAPEl 



■WORD ERRl 
,WORD 
, RAD50 /TPl/ 
,BYTE 1,3 
,RAD50 /DT/ 



BIN40 



.WORD 100 
,WORD BUFFER 
,WORD 200 
,WORD 4 
WORD 



STARTING BLOCK # 

STARTING ADDRESS IN CORE 

NUMBER OF WORDS 

INPUT 

FOR MONITOR USE 



ERRl 



; ERROR ROUTINE FOR DECTAPE 



BUFFER: 
BUFEND : 



WORD 
BLKW 200 



END 
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.WAIT 

3.6.10 .WAIT - Wait for completion of process on dataset. 

Macro Call ; .WAIT #LNKBLK 

where LNKBLK is the address of the Link Block (see Figure 3-6). 

Assembly Language Expansion : 

EMT 1 
Global Name ; (Routine is embedded in the resident Monitor.) 

Description ; .WAIT tests for completion of the last requested action 
on the dataset represented by the referenced Link Block. If the action 
is complete (that is, if the request has completed all its action) , 
control is returned to the user at the next sequential instruction 
following the assembly language expansion; otherwise, the Monitor re- 
tains control until the action is complete. A .WAIT or .WAITR should 
be used to ensure the integrity of data transferred to or from a line 
buffer. The argument is removed from the stack. 

Rules ; The dataset must be INITed. 

Errors : If the dataset is not INITed, a fatal error occurs and 
FOOO is printed on the teleprinter. 



3-35 



.WAITR 

3.6.11 . WAITR - Check for completion of processing on dataset and 
return or transfer. 

Macro Call : .WAITR #LNKBLK, #ADDR 

where LNKBLK is the address of the Link Block, and ADDR is the address 

to which control is transferred if the processing is not complete. 

Assembly Language Expansion : 

MOV #ADDR,-(SP) 
MOV # LNKBLK, -(SP) 
EMT 

Global Name : (Routine is imbedded in the resident Monitor. ) 

Description : .WAITR tests for completion of the last requested 
action on the specified dataset. If all actions are complete, control 
is returned to the user at the next sequential instruction following 
the assembly language expansion. If all actions are not complete, 
control is given to the instruction at location ADDR. The arguments 
are removed from the stack. It is the user's responsibility to return 
to the .WAITR to check again. 

Rules : The user should use a .WAIT or a .WAITR request to 

assure the completion of data transfer to the user's line buffer be- 
fore processing the data in the buffer, or moving data into it. The 
dataset must be INITed. 

Errors: If the dataset is not INITed, a fatal error occurs 
and FOOO is printed on the teleprinter. 
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.SPEC 

3- 6. 12 .SPEC - Special functions. 

Macro Call: .SPEC #LNKBLK, #SPCARG 

where LNKBLK is the address of the Link Block, and SPCARG may be 

either a special function code or the address of a special function 

block containing the code (see Figure 3-15) , depending upon the 

function. 

Assembly Language Expansion : 

MOV #SPCARG,-(SP) 
MOV # LNKBLK, -(SP) 
EMT 12 

Global Name : SPC 

Description : This request is used to specify a special function 
(action) to a device, such as rewind magnetic tape. A code identifies 
the function and must be in the range 0-255]_q. When the function 
requires no supporting data, the code itself is the first parameter 
to be placed upon the processor stack in the assembly language call 
sequence. However, if the user must supply additional information 
or if the function expects to return data to the user, the code 
is passed within a special function block and the address of the 
block is the call parameter. The format of this block is shown in 
Figure 3-15. 

If a .SPEC request is made to a device which has no special 
function code, an immediate return is made showing that the function 
has been complete. After the request has been started, control is 
returned to the user at the instruction following the assembly lan- 
guage expansion. The stack is cleared. 

Rules : The dataset must be INITed. 

Errors : Fatal error FOOO is returned if the dataset has not 
been INITed. 
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.STAT 



3.6.13 .STAT - Obtain device status. 



Macro Call; 



.STAT #LNKBLK 



where LNKBLK is the address of the Link Block. 

Assembly Language Expansion : 

MOV # LNKBLK,- (SP) 
EMT 13 



Global Name: 



STT 



Description : Determine for the user the characteristics of the 
device specified in the Link Block. After the request has been com- 
pleted, control is returned to the user at the instruction following 
the assembly language expansion. This request returns to the user 
with the following information at the top of the stack. 

SP Driver Facilities Word 

SP+2 Device Name (Packed Radix-50) 

SP+4 Device Standard Buffer 
Size (in words) 

where Driver Facilities Word has the following format; 



15 14 13 12 



1 = device is directo 

structured 
1 = device is DECtape 
1 = device is sequential magnetic 
1 = system disk driver ■ 
1 = device has multiple \xnits 

one controller 
1 = device is a terminal 
1 = driver has an OPEN entry 





= device will support multi- 
dataset activity 
1 = device will handle output 
■1 = device will handle input 
1 = device will handle binary data 
1 = device will handle ASCII data 
1 = driver has a special function 

entry 
1 = driver has a CLOSE entry 



Device Name is the Radix-50 packed ASCII standard mnemonic for the 
device (Appendix A) ; and. Device Standard Buffer Size is the block 
size (in words) on a blocked device or an appropriate grouping size 
on a character device. 



Rules: 



The dataset must be INITed. The user must clear the 



stack upon return. 
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.ALLOC 

3.7 REQUESTS FOR DIRECTORY xMANAGEMENT SERVICES 

3.7.1 .ALLOC - Allocate (create a contiguous file). 

Macro Call ; .ALLOC #LNKBLK, #FILBLK, #N 

where LNKBLK is the address of the Link Block, FILBLK is the address 
of the Filename Block, and N is the number of 64-word segm.ents re- 
quested. 

Assembly Language Expansion : 

MOV #N,-(SP) or MOV #N+ljeS0;^j00/- (SP) 
MOV #FILBLK,-(SP) 
MOV # LNKBLK, -(SP) 
EMT 15 

Global Name : ALO (See Appendix C for subsidiary routines.) 

Description ; Searches the device for a free area equal to N 64- 
word segments, and creates a contiguous file in the area if it is 
found, by making an appropriate entry in the User File Directory (UFD) 
If the sign bit (bit 15) of N is set, the UFD pointer will point to 
the beginning of the allocated area thereby indicating that the file 
is empty. This enables partial filling of the file space and later 
extension of the file. If the sign bit of N is not set, the UFD 
pointer will point to the end of the allocated area and thereby indi- 
cate that the file area is full and may not later be extended. 
(Linked files are created by an .OPENO request.) Search begins at 
the high end of the device. The number of blocks allocated will be 
the minimum number required to contain N segments, i.e.. 



|] 



where B is the number of 64-word segments per block. For example, if 

256 
N=9 and the device soecified is DECtaoe. then B=— ^^^ = 4. Therefore, 
N 9 ^ - ■ b4 

^'-= T ~ 3, and 3 blocks will be allocated. 

After the request has been completed, control is returned to the 
user at the instruction following the assembly language expansion. 
The arguments are removed from the stack, and the top word of the 
stack will be set to -1 to indicate the successful completion of the 
request, or to the largest number of segments currently available if 
this is less than the called request. The value will be meaningless 
if the call cannot be met by reason of any other error. 
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Rules: 



, ALLOC (cont) 



Must be preceded by an .INIT request on the dataset. 



A Filename Block must be set up by the user in his program. 

Errors : Control is returned either to the ERROR RETURN ADDRESS 
in the Filename Block if it is specified, or to the teleprinter for 
an error message if it is not. Possible errors are shown below: 



Error Condition 

Device Not Ready 
Dataset Not INITed 
File Exists 
Directory Full 
UIC Not In Directory 
Illegal Filename 



Error Code Returned 
To Filename Block 



2 
12 
13 
15 



Error Message 
On Default 

A002 
FOOO 
F024 
F024 
F024 
F024 



If the error address in the Filename Block is taken, the top word of 
the stack is meaningless. 



Create a contiguous file of four 256, ^ word blocks 



Example : 

on DECtape unit 4. Name the file FREQ.DAT. 



FRQ: 



FREQIN 



.ALLOC 


#FRQ,#FREQIN,#20 


INC 


@SP 


BNE 


NOROOM 


.WORD 


ERRl 


.WORD 





, RAD 50 


/DTA/ 


.BYTE 


1,4 


.RAD50 


/DT/ 


.WORD 


ERR2 


.WORD 





.RAD50 


/FRE/ 


.RAD50 


/Q/ 


.RAD50 


/DAT/ 


.WORD 


UICPROTl 



ERRl: 
ERR2: 



;T0 HERE IF NO BUFFER AVAILABLE 

;FOR DRIVER 

;T0 HERE IF FILE STRUCTURED ERROR 



NOROOM: 



;T0 HERE IF NOT ENOUGH CONTIGUOUS 
; BLOCKS ON DEVICE 



3-40 



.DELET 

3.7.2 .DELET - Delete a file. 

Macro Call: .DELET #LNKBLK, #FILBLK 

where LNKBLK is the address of the Link Block, and FILBLK is the ad- 
dress of the Filename Block. 

Assembly Language Expansion : 

MOV #FILBLK,-(SP) 
MOV #LNKBLK,- (SP) 
EMT 21 

Global Name : DEL (See Appendix C for subsidiary routines.) 

Description : Deletes from directory-oriented device the file named 
in the Filename Block. After the request has been completed, control 
is returned to the user at the instruction following the assembly 
language expansion. The arguments are removed from the stack. 

Rules : .DELET operates on both contiguous and linked files. 

If the file has been OPENed, it must be CLOSEd before it is deleted. 

Errors : Control is returned either to the ERROR RETURN ADDRESS 

xn tuS X ij.ename ijj-ocK Ij. lu is specij-ieo, or to i_he texeprxnter i.or an 
error message if it is not. Possible errors are shown below: 

Error Code Returned Error Message 
Error Condition To Filename Block On Default 

Device Not Ready — A002 

Dataset Not INITed — FOOO 

Nonexistent File 2 F024 

Protect Code Violation 6 F024 

File Is Open 14 F024 
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.RENAM 

3.7.3 .RENAM - Rename a file. Change protection code. 

Macro Call : .RENAM #LNKBLK, #OLDNAM,#NEWNAM 

where LNKBLK is the address of the Link Block, OLDNAM is the address of 
the Filename Block representing the file, and NEWNAM is the address of 
the Filename Block containing the new information. 

Assembly Language Expansion : 

MOV #NEWNAM,-(SP) 
MOV #OLDNAM,- (SP) 
MOV #LNKBLK,-(SP) 
EMT 20 

Global Name : REN (See Appendix C for subsidiary routines.) 

Description : Allows the user to change the name and protection code 
(see Section 3.8.6.3) of a file. After the request has been completed, 
control is returned to the user at the instruction following the assem- 
bly language expansion. The arguments are removed from the stack. 

Rules: Dataset must be INITed, and file must not be OPENed. 

The user must specify two Filename Blocks: one contains the name and 
protection code of the file as it presently is before the .RENAM re- 
quest, and the other contains the name and protection code of the file 
as it should be after the .RENAM request. The two filenames must be 
different. To change just the protection for a file, two .RENAMs must 
be requested. 

The new filename must not already exist, and the new filename 
must be legal. The old file must exist. 



NOTE 
Renaming a file assigned from the keyboard to the 
dataset will effectively be a NOP. 

Errors : Control is returned either to the ERROR RETURN ADDRESS 

in the offending Filename Block if it is specified and applicable, or 

to the Monitor for an error message if it is not. Possible errors 

are shown below: 

Error Code Returned Error Message 
Error Condition To Filename Block On Default 

Datiiset Not INITed 
File Exists (new name) 
File Nonexistent (old file) 
Protection Violation 
File Is Open 
Illegal Filename 






FOOO 


2 


F024 


2 


F024 


6 


F024 


14 


F024 


15 


F024 
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.APPND 

3.7.4 .APPND - Append one linked file to another. 

Macro Call : .APPND #LNKBLK, #FIRST,#SECOND 

where LNKBLK is the address of the Link Block/ FIRST is the address of 

the Filename Block for the first file (file to be appended to) , and 

SECOND is the address of the Filename Block for the second file (file 

to be appended) , 

Assembly' Language Expansion : 

xMOV #SECOND,-(SP) 
MOV #FIRST,-(SP) 
MOV #LNKBLK,- (SP) 
EMT 22 

Global Name : APP (See Appendix C for subsidiary routines.) 

Description : Makes one linked file out of two by appending the 
SECOND to the FIRST. The directory entry of the SECOND file is 
deleted. When the request is completed, control is returned to the 
user at the instruction following the assembly language expansion. 
The arguments are removed from the stack. No attempt is made to pack 
the two files together, the physical blocks are merely linked together, 

Errors : Control is returned either to the ERROR RETURN ADDRESS 

in the offending Filename Block if it is specified, or to the tele- 
printer for an error message if it is not. Possible errors are 
shown below: 

Error Code Returned Error Message 
E rror Condition To Filename Block On Default 

Device Not Ready 

Dataset Not INITed 

First File Nonexistent 2 

Contiguous File 5 

Protect Code Violated 6 

File Opened 14 



NOTE 

Since the last block of a file is typically not 
full, there will be a gap (null characters) in 
the new file at the junction point. This causes 
no problem in ASCII files but might cause 
confusion in binary files. 



A002 


FOOD 


F024 


F024 


F024 


F024 
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.LOOK 

3.7.5 .LOOK - Search the device directory for a specified filename. 

Macro Call : .LOOK #LNKBLK,#FILBLK [ ,1] 

where LNKBLK is the address of the Link Block, and FILBLK is the 

address of the Filename Block. 

Assembly Language Expansion : 

a. If the optional argument is not specified: 

MOV #FILBLK,-(SP) 
MOV # LNKBLK,- (SP) 
EMT 14 

b. If the optional argument is specified: 

MOV #FILBLK,-(SP) 
CLR -(SP) 
MOV #LNKBLK,-(SP) 
EMT 14 

Global Name : DIR (See Appendix C for subsidiary routines.) 

Description : The primary purpose of this routine is to search 
through a specified directory for a specified file and return with the 
current parameters of the file. However, this routine can also be 
used to indicate (bits 0-3) the permissible functions for a nondirec- 
tory device (i.e., input, output, update, etc.). By specifying the 
optional argument, the user indicates whether he requires two or 
three parameters be returned. 

The device to be searched is specified in the Link Block, and the 
file is specified in the Filename Block. The request returns to the 
user with the top elements of the stack as follows 

3 Arg. Call 
SP 

SP+2 
SP+4 

where # OF BLOCKS is the number of blocks in the file, and the 
INDICATOR WORD is coded as follows: 

.OPENC allowed 
.OPEN I allowed 
.OPENE allowed 
.OPENU allowed 
File is not in use 

File is being used by another dataset 
Dataset already has a file open 
(no search has been performed) 
File is linked 
File is contiguous 
File nonexistent (OPENO allowed) 
7=1 File exists or .OPENO not allowed 
Bits 8-15 Protection Code 
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2 Arg. Call 


START BLOCK 




# OF BLOCKS 


SP 


INDICATOR WORD 


SP+2 



Bit 


0=1 


Bit 


1=1 


Bit 


2=1 


Bit 


3=1 


Bit 


4=0 




4=1 


Bit 


5=1 


Bit 


6=0 




6=1 


Bit 


7=0 



After the request has been completed, control is returned to the 
user at the instruction following the assembly expansion. The stack 
must be cleared by the user. If a file is protected against READ 
access, it will be signaled as nonexistent. 

Rules : The dataset must be INITed. 

Errors: Control is returned either to the ERROR RETURN ADDRESS 

in the Filename Block if it is specified, or to the teleprinter for an 
error message if it is not. Possible errors are shown below: 

Error Code Returned 
Error Condition To Filename Block Error Message 

Device Not Ready 

A File Is Open On 
Requesting Dataset 

Illegal Filename 

Note that it is possible to .LOOK for a file and be told that it 
does not exist. A subsequent attempt to open the nonexistent file 
may lead to an OPEN error (code=2) . Hence, it may be more efficient 
to simply attempt the .OPEN and check for an error (see Section 3.6.3) 



__ 


A002 


14 


F024 


15 


F024 
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.KEEP 

3.7.6 .KEEP - Protect file from automatic deletion. 

Macro Call : .KEEP #LNKBLK, #FILBLK 

where FILBLK is the address of the Filename Block of the file to be 

protected and LNKBLK is the address of the Link Block. 

Assembly Language Expansion : 

MOV #FILBLK,-(SP) 
MOV #LNKBLK,-(SP) 
EMT 24 

Global Name : PRO 

Description : Protects the named file from being deleted by the 
Monitor upon a Finish Keyboard command (see Chapter 2) . It does this by 
setting bit 7 of the PROTECT byte in the Filename Block. Automatic 
deletion upon Finish is not currently implemented. 
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3.8 REQUESTS FOR MISCELLANEOUS SERVICES .RUN 

3.8.1 Load a Program or an Overlay 

3.8.1.1 .RUN 

Macro Call ; .RUN #RUNBLK 

where RUNBLK is the address of the user's Run Block (see Figure 3-16). 

Assembly Language Expansion : 

MOV #RUNBLK,- (SP) :PUSH ADDRESS OF THE RUN BLOCK 
EMT 65 ;ONTO THE STACK 

Global Name : RUN 

Description : The RUN request may be used to load an entire program 

or a program overlay. It has several options, among which are: 

load a program or load an overlay - when an overlay is 
loaded, the existing program environment is not disturbed; 
one section of the program is simply replaced by another. 
When a new program is loaded, the old program and its 
effects (except for data on the stack) are purged from 
core, and the new program takes over; for example, FORTRAN 
can use the RUN request to load LINK and LINK can use it 
to load and execute the user's program; 

load a core image or a load module; 

return of control: 

instruction following .RUN; 

transfer address of load module or core image; 

transfer address plus offset (word F) ; 

alternate return address (word G); 
stack movement: 

leave as is; 

move the stack down if it vrould otherwise be destroyed 
by the entity being loaded; 

load address: 

as specified in file, 

as specified by user. 

The RUN request requires the following control blocks: 

Run Block: A variable length control block whose address is 
passed on the stack. It contains a function word 
and various optional parameters. It is described 
in Section 3.9.8. 

Link Block: The standard Link Block (section 3.9.1). It de- 
scribes the device from which the entity is to be 
loaded. It is required unless bit 15 of the function 
word in the Run Block is 1. 
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.RUN (cont) 

File Block: The standard File Block (section 3.9.2). It de- 
scribes the file from which the entity is to be 
loaded: either an . LDA file or a CIL. It is 
required unless bit 15 of the function word 
in the Run Block is 1. 

The Link Block should not be .INITed, nor should the File Block be 

.OPENed, when .RUN is called. RUN will perform .OPEN, .CLOSE, . INIT 

and .RLSE processing. The lookup sequence is as follows: 

First an extension of LDA is attempted, then no extension, 
unless an extension is specified, in which case it alone 
is used; 

For each extension, the current UIC, then [1,1] is tried, 
unless a UIC is specified, in which case it alone is used; 

The .RUN request always removes the Run Block address from the stack. 
If bit is 0, the following information will be returned upon the 
stack: 

(SP) - transfer address of loaded module, 
2(SP) - size of loaded module in bytes, 
4 (SP) - low address of loaded module. 

Aside from this, the stack is not disturbed, although it may be moved. 
This means that the stack may be used for passing arguments. 

Rules: The Link Block should not be .INITed. 

The File Block should not be .OPENed. 

If an overlay is being loaded, it must not extend 
above the bottom of the resident program section, 
nor below the top of the Monitor. 

If a new program is to be loaded, all datasets used 
by the current program must be RLSEd. 

The user must be sure that his stack is not inadvert- 
ently destroyed. 

When options are requested through the function word, 
the appropriate supporting data must be present in 
the Run Block. 

If the stack might be moved, it must not contain 
absolute pointers to locations within the stack. 
For example: 

MOV SP , Rj3 
MOV RiZl,-(SP) 

produces a stack which should not be moved. The 
user can assure that such a stack will not be moved 
by setting bit 1 of the Function word in the RUN 
Block to (see Section 3.9.8). 

Errors : Errors F007, F012, F021, F022, F024, F045, F054, F274, F276, 
and F277 are all possible. All but F007 and F021 are nonfatal, pro- 
vided that an error return is provided in the File Block (see Table 3-4) 
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.EXIT 

3.8.2 Request to Return Control to the Monitor 

3.8.2.1 .EXIT - Exit from a user program to Monitor. 

Macro Call : .EXIT 

Assemblv Languacre Expansion: 
EMT 60 

Global Name ; XIT 

Description : This is the last statement executed in a user's pro- 
gram. It returns control to the Monitor, assures that all of the pro- 
gram's data files have been closed and, in general, prepares for the 
next keyboard request. After the exit, all Monitor buffer space re- 
served for the program, such as Device Assignment Tables (DAT) estab- 
lished during program execution, are returned to free core. 
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.TRAP 

3.8.3 Requests to Set Monitor Parameters 

In addition to the above programmed requests, the user can provide 
the Monitor with data to be stored in Monitor Tables or can request 
information on the content of those tables via the EMT level 41 in- 
struction. The user communicates his request to the Monitor by pushing 
the necessary parameters and an identifier code onto the stack. If the 
code is outside the ranges of those currently established, a fatal 
error (F002) will result. 

3.8.3.1 .TRAP - Set interrupt vector for the trap instruction. 

Macro Call : .TRAP # STATUS, #ADDR 

where STATUS is the desired status for the trap, and ADDR is the 

address for the trap. 

Assembly Language Expansion : 

MOV #ADDR,-(SP) 

MOV #STATUS,-(SP) 

MOV #1,-(SP) ;1 is the identifier code for .TRAP 

EMT 41 

Global Name : GUT 

Description ; Sets the STATUS and ADDR into trap vector 34. After 
the request is completed, control is returned to the user at the in- 
struction following the assembly language expansion. The stack is 
cleared. The user may then use the trap instruction. 

Rules : STATUS must be a valid Status Byte. 

ADDR must specify an address within the user's core area. 

Errors : If an invalid code is specified, a fatal (F002) error 
will result. 
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.RSTRT 

3.8.3.2 .RSTRT - Set the default address for use by the REstart 

keyboard command. 
Macro Call : .RSTRT #ADDR 

where ADDR is the restart address. 

Assembly Language Expansion : 

MOV #ADDR,-(SP) 

MOV #2,-(SP) ;2 is the identifier code for .RSTRT 

EMT 41 

Global Name : GUT 

Description : Sets the address where the program should restart in 
response to the keyboard command REstart. This is the assumed address 
in the absence of an address in the REstart command. It can be reset 
as often as requested by the program. After the request is completed, 
control is returned to the user at the instruction following the 
assembly language expansion. The stack is cleared - 

Rules: ADDR must be an address within the user's core area. 
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.CORE 

3.8.4 Requests to Obtain Monitor Parameters 

3.8.4.1 .CORE - Obtain address of the highest word in core memory. 
Macro Call : .CORE 

Assembly Language Expansion : 

MOV #100,- (SP) ;CODE 
EMT 41 

Global Name : GUT 

Description ; Determines the address of the highest word in core 

memory (core size minus 2) and returns it on the top of the stack. 

For an 8K machine, it would return 3777 6. The user m.ust clear the 
stack. 



Errors : No errors are possible, 
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.MONR 

3.8.4.2 .MONR - Obtain the address of the first word not within 
the resident Monitor. 

Macro Call : .MONR 

Assembly Language Expansion : 

EMT 41 

Global Name : GUT 

Description : Determines the first word above the top of the cur- 
rently resident Monitor (see Figure 3-5) and returns it to the user 
at the top of the stack. This value does not reflect any area 
allocated by the Monitor for control blocks, device drivers, data 
buffers, etc. (see .MONF, Section 3.8.4.3). After the request is 
completed, control is returned to the user at the instruction follow- 
ing the assembly language expansion. The user must clear the stack. 

Errors: No errors are Dossible. 
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.MONF 



3.8.4.3 .MONF - Obtain the address of the first word above the 
Monitor's highest allocated free core buffer. 

Macro Call : . MONF 

Assembly Language Expansion : 

MOV #102,- (SP) 



Global Name: 



EMT 41 

GUT 

The address of the first word above total Monitor area 



Description : 

(see Figure 3-5) , including the buffer and transient areas current at 
the time of the request, is returned to the user at the top of the stack, 
After the request is completed, control is returned to the user at the 
instruction following the assembly language expansion. The user must 
clear the stack. 



Rules ; Since buffers are allocated by the Monitor in its 

processing of certain requests, .MONF should be placed in the program 
at the point where the information is actually required. 
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Figure 3-5 Core Map of Resident Monitor and Full Monitor. 
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.DATE 

3.8.4.4 .DATE - Obtain current date. 
Macro Call : .DATE 

Assembly Language Expansion ; 

MOV #103,- (SP) 
EMT 41 

Global Name : GUT 

Description : The current date word is returned to the user at the 
top of the stack. The user must clear the stack. The date format is 
a binary number equal to Julian-70 ,000, «. If the user requires the 
ASCII representation of the date, he should use the .CVTDT request 
(see 3.8.4.6) . 

Errors: No errors are possible. 
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.TIME 



3.8.4.5 .TIME - Obtain current time of day. 
Macro Call : . T IME 

Assembly Language Expansion ; 

MOV #104, -(SP) 
EMT 41 

Global Name : GUT 

Description : The two current time words are returned to the user 
at the top of the stack. 



SP: 


LOW-ORDER TIME IN TICKS 


SP+2: 


HIGH- ORDER TIME 



where a TICK is 1/60 of a second (1/50 second for 50-cycle lines) 

The words are 15-bit unsigned numbers. The user must clear the 
stack. See the CVTDT request for how to obtain the ASCII repre- 
sentation of current time value. 

Errors; No errors are possible. 
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.CVTDT 

3.8.4.6 . CVTDT - Convert binary representation of date or time to 
ASCII character string. 

Macro Call : .CVTDT #CODE, #ADDR[ , VALUE] 

where CODE identifies the conversion to be done; 

CODE = Current date as stored by monitor, 

CODE = 1 Current time as stored bv monitor. 

CODE = 2 Date supplied as VALUE, 

CODE = 3 Time supplied as VALUE (and VALUE+2) 

ADDR is the address of the first byte of the user buffer into which 

the ASCII string is to be stored, and VALUE is the address of user 

supplied Date or Time (used with CODEs 2 and 3 only) . 

Assembly Language Expansion : 

MOV VAI.UE+2,-(SP) : Code 3 only 

MOV VALUE, -(SP); Codes 2 and 3 only 

MOV #ADDR,-(SP) 
MOV #CODE,-(SP) 
EMT 66 

Global Name : CDT 

Description : This request converts either a date or a time from 
internal (binary) representation into an ASCII string suitable 
for display. The user may specify that the current system value 
(of date or time) is to be used for conversion or he may supply 
his own value. The string returned has the format of the Date and 
Time returned by the Keyboard DATE and TIME commands (see Chapter 2). 
Upon return, the call arguments have been removed from the stack and 
condition codes N, Z and V are cleared to 0. 

Biiles: 1. The buffer area supplied by the user program (starting 
at ADDR) must provide sufficient room for the text 
returned as no check is made. Nine bytes are required 
for Date, eight bytes are required for Time. 
2. User-supplied VALUES for Date or Time must comply 

with the internal storage format of those values, that 
is: 

a. Date; 1 word containing (year-197j0) *lj000 + day 

of the year (Julian) . 

b. Time; 2 unsigned integer words for high-order 

and low-order time in clock ticks. 
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.CVTDT (cont) 

Errors : 1. Specification of an illegal CODE (i.e., > 3) causes 
fatal error message: 

FJ03 4 Call address 

2. If the currently stored Date or Time is out of range 
(i.e., Date > 366 (Modulo 10910) or Time > 47:59:59), an 

operator action message 

A011 C0DE(j2l = Date, 1 = Time) 
is printed. The operator should enter the desired 
value via the appropriate DAte or Time keyboard 
command and type continue to proceed. If 23:59:59- 
< Time < 48:00:00, Date is incremented and Time is 
reduced by 24:00:00. 

3. If a user supplied Date or Time is out of range as 
above, the conversion routine will return without 
attempting conversion and the condition code V will 
be set to 1. Thus the program should follow the 
.CVTDT request with the check: 

BVS (error routine) . 
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.GTUIC 

3.8.4.7 .GTUIC - Get the current user's UIC. 
Macro Call : .GTUIC 

Assembly Language Expansion ; 

MOV #105, -(SP) ;CODE 
EMT 41 

Global Name : GUT 

Description : The current user ' s UIC is returned at the 
top of the stack. The user must clear the stack. 



Errors; No errors are possible. 
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.SYSDV 

3.8.4.8 . SYSDV - Get name of the system device. 
Macro Call : . SYSDV 

Assembly Language Expansion : 

MOV #106,- (SP) 
EMT 41 

Global Name ; GUT 

Description : The name of the system device in Radix-50 notation is 

returned to the user at the top of the stack. 

Errors; No errors are possible. 
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.GTPLA 

3.8.4.9 . GTPLA - Return the current program low address. 
Macro Call ; .GTPLA 

Assembly Language Expansion ; 

CLR -(SP) 
MOV # 5 / - ( SP ) 
EMT 41 

Global Name ; GUT 

Description ; The program low address is the address of the first 
(lowest) word of the current program. In the case of a program with 
overlays, the PLA is the address of the first word of the resident 
section. PLA is established when the keyboard RUN command is executed 
or when the .RUN request is used to load a new program (not an over- 
lay, e.g., when MACRO calls CREF, which then replaces MACRO). Because 
the .RUN processor will not load an overlay which extends above this 
address, the PLA is also called the Protection Boundary. 

.GTPLA allows the user to retrieve this value (see Figure 3-5) , 
which is returned to the top of the stack. .STPLA allows the user to 
set it. 

Rules ; The user must clear the stack. 

Errors ; No errors are possible. 
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.STPLA 

3.8.4.10 . STPLA - Set the program low address. 

Macro Call : .STPLA #ADDR 

where ADDR is the desired new program low address. 

Assembly Language Expansion : 

MOV #ADDR,-{SP) 
MOV #5,-(SP) 
EMT 41 

Global Name : GUT 

Description : This request allows the user to establish a new pro- 
gram low address. This is done if the user wants part of his resident 
code overlayed or if he wants to reserve additional space between his 
resident code and his overlays. Consult the .GTPLA description for 
more details. 

The old program low address (or a zero) will be returned on top 
of the stack upon return from this macro call. 

Rules: The user is required to clear the returned address 

from the stack. 

Errors: The address returned on top of the stack will be zero 
when the call is unsuccessful. This occurs when the address is out- 
side of available memory. 
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.GTCIL 

3.8.4.11 .GTCIL - Return the address of the first block of the 
Monitor core image library (CIL) . 

Macro Call : .GTCIL 

Assembly Language Expansion : 

MOV #111,- (SP) 
EMT 41 

Global Name : GUT 

Description : This request returns the address of the first block 
of the Monitor core image library to the top of the stack. 

Rules: The user is required to clear the disk address returned 

on ^~]^'^ S"'~3.'^]v 

Errors : No errors are possible. 
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.GTSTK 

3.8.4.12 .GTSTK - Return the current stack base entry. 
Macro Call : .GTSTK 

Assembly Language Expansion : 

CLR -(SP) 
MOV #4,-(SP) 
EMT 41 

Global Name : GUT 

Description : The stack base is the highest core address used for 
stack storage plus two. A RUN Keyboard command clears the stack and sets 
the stack base address to the program low address. A user .RUN request 
does not clear the stack (to allow inter-program communication via the 
stack) but the stack may be relocated. This request may be used to 
determine the stack base. Following the request the current stack 
base entry is returned on top of the stack. 

Rules : The user is required to clear the returned value from 

the stack. 

Errors: No errors are possible. 
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=STSTK 

3.8.4.13 .STSTK - Modify the stack base entry. 

Macro Call : .STSTK #ADDR 

where ADDR is the desired new stack base address entry. 

Assembly Language Expansion : 

MOV #ADDR,-(SP) 
MOV #4,-(SP) 
EMT 41 

Global Name : GUT 

Description : This request is used when the stack is to be relocated. 
It does not relocate the stack, but it does record its new base (the 
address of the word immediately above the stack; see section 3.8.4.12), 
and it returns the old stack base on the stack. EXTREME CAUTION should 
be used when moving the stack; it is not recommended as a standard 
procedure. Note that the .RUN request may be used to move the stack 
when that is appropriate. 

Rules : The user must clear the old base value from the stack 

when control is returned. 

The user is responsible for moving the stack. 

Caution should be used when moving the stack, since the new and 

old stack areas may overlap and since Monitor interrupt routines may 

use the stack while it is being moved. Let: 

SBl = old stack base (returned on stack) 
SB2 = new stack base (supplied by user) 
SPl = old stack pointer (current value of SP) 
SP2 = new stack pointer (SB2 - SBl + SPl) 

First, set SP=min (SP1,SP2) to protect against interrupts. Then if 

SBKSB2, move the stack starting from the base (SBl to SB2) , If 

SB1>SB2, move the stack starting from the top (SPl to SP2) . This 

strategy prevents the stack from being corrupted during the move 

(since the two stack areas might overlap). Finally, set SP to SP2. 

Errors : If the new stack base ADDR is outside available memory 
or inside the Monitor, the request is not honored and a zero is re- 
turned on the stack. 
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.STFPU 



STFPU 



3.8.4.14 . STFPU - Initialize the floating-point exception vector. 
Macro Call : .STFPU #PSW,#ADDR 

Assembly Language Expansion : 

MOV #ADDR,-(SP) ;ADDRESS OF EXCEPTION ROUTINE 
MOV #PSW,-(SP) ;PROGRAM STATUS WORD FOR 

; EXCEPTION RTN 
MOV #3,-(SP) ; REQUEST CODE 
EMT 41 

Global Name : GUT 

Description : This request initializes the exception interrupt 

vector for the floating-point processor on the PDP-ll/4j2f or PDP-11/45. 

Any floating-point exception for which interrupt is enabled will cause 

a trap to location ADDR with a new program status word of PSW. The 

interrupt vector is at location 244o. 

Rules; None . 

Errors : None . 
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.RADPK 

3.8.5 Requests to Perform Conversions 

Using the EMT level 42 instruction the user can request data 
conversions between binary and some external form such as decimal 
ASCII or Radix-50. He communicates his request by pushing the nec- 
essary parameters and an identifier code onto the stack. If a code 
outside the range of those currently established is specified, a 
fatal error (F034) will result. 

3.8.5.1 .RADPK - Pack three ASCII characters into one Radix-50 word, 

Macro Call : .RADPK #ADDR 

where ADDR is the address of the first byte in the 3-byte string of 

A^'^II '^h ^''^ ^ '^''"^r s ''"'^ be converted. 

Assembly Language Expansion : 

MOV #ADDR,-(SP) 

CLR -(SP) ;MOVE CALL CODE ONTO STACK 

EMT 42 

Global Name: CVT 

Description : The string of 7- or 8-bit ASCII characters in three 
consecutive bytes starting at ADDR is converted to Radix-50 packed 
ASCII using the algorithm shown below. The packed value is returned 
on the top of the stack, followed by the address of the byte follow- 
ing the last character converted. The user must clear the stack. 

Radix-50 is used by the Monitor to store in one word three 
characters for half a filename or an extension or other three- 
character sets of data. 

Because the characters allowed within names (e.g., filenames 
or extensions, assembler sinnbols, etc.) are restricted to letters, 
digits, and a few special characters, it is possible to store three 



((C^ X 50g) + C^) X 50g + C3 

where C, , C^, and C^ are the three characters converted from their 
original ASCII value to the value shown in the following table. 
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.RADPK (cont) 



ASCII Value 



Radix-50 Value 



Space 


40 





A-Z 


101-132 


1-32 


$ 


44 


33 


. 


56 


34 


unused 




35 


0-9 


60-71 


36-47 



The maximum value for three characters is thus: 

47 X 50^ + 47 X 50 + 47 = 174777 

The Radix-50 representation for various peripheral devices is 
shown below: 



Mnemonic Device 

CR Card Reader (CRll) 

DC RCll Disk 

DF RFll Disk 

DK(A,B) RKll Disk 

DT(A) DECtape (TCll) 

KB ASR-33 Keyboard/Printer 

LP Line Printer (LPll) 

MT Magtape (TMll) 

PP High-Speed Paper Tape Punch 

PR High-Speed Paper Tape Reader 

PT ASR-33 Paper Tape Device 



Radix-50 
Equivalence 

012620 

014570 

014760 

015270(+1,2) 

016040 (+1) 

042420 

046600 

052140 

063200 

063320 

063440 



NOTES: a. Device mnemonics may be three letters on some systems. 

The third letter is assigned if there is more than one 

controller. For example: 

DTA for DECtape controller A 
DTB for DECtape controller B 

b. The device name may be followed by an octal number to 

identify a particular unit when the controller has 

several device units associated with it. For example: 

DTI for unit 1 under a single DECtape control 

DTAl for unit 1 under controller A in a multi- 
controller situation. 

Errors : The conversion will be stopped if an error condition 

is encountered, and the user will be informed of the type of error 

via the condition codes in the Processor Status register: 

C-bit set means that an ASCII byte outside the valid 
Radix-50 set was encountered. 

The value returned will be left- justified and correct up to the last 

valid byte, e.g., DT: = DT : . The address returned will be that of 

the first invalid byte. 
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.RADPK (continued) 

If no errors were encountered during the conversion, the con- 
dition codes will be cleared. 

Example : Pack a string of 30, j^ ASCII characters, starting at 
UNPBUF, into a buffer starting at PAKBUF. 

MOV #PAKBUF,R3 ; SET UP POINTER TO PACK BUFFER 

MOV #UNPBUF,-(SP) ;. RADPK UNBUF 

NEXT: CLR -(SP) 

EMT 42 

BCS ERRC ; INVALID ASCII CODE ENCOUNTERED 

MOV (SP)+,(R3)+ ;MOV PACKED VALUE TO BUFFER 

CMP R3,#PAKBUF+12 ;END OF STRING? 

BNE NEXT ;N0 

TST (SP)+ ;YES - REMOVE POINTER FROM STACK 

Note that this example takes advantage of the fact that the Monitor 
returns on the stack the address of the byte v/hich follows the last 
character converted. 
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.RADUP 

3.8.5.2 .RADUP - Unpack one Radix-50 word into three ASCII characters 

Macro Call ; .RADUP #ADDR,WORD 

where ADDR is the address of the first of three bytes into which the 
unpacked characters are to be placed, and WORD is the Radix-50 word 
to be converted. 

Assembly Language Expansion : 

MOV WORD,- (SP) 

MOV #ADDR,-(SP) 

MOV #1,-(SP) ;MOVE CALL CODE ONTO STACK 

EMT 42 

Global Name ; CVT 

Description ; WORD is converted into a string of 7-bit ASCII char- 
actors which are placed left-justified with trailing spaces in three 
consecutive bytes starting at location ADDR. The stack is cleared. 
See section 3.8.5.1 for a definition of Radix-50. 



Errors : if an error is encountered, the user will be informed 

via the condition codes in the Processor Status register. 

C-bit set means: a. a value of WORD was outside the valid 

Radix-50 set, i.e., >I74777 (see 
Section 3.8.5.1) . 

b. a Radix-50 byte value was found to be 
35, which is currently not used. 

Nevertheless, three bytes will be returned with a : as the first of 

the three for error type (a) , and a / for any of the three bytes for 

error type (b) . 

If the conversion is satisfactory, the condition codes are 

cleared. 
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.D2BIN 

3.8.5.3 .D2BIN - Convert five decimal ASCII characters into one 
binary word. 

Macro Call : .D2BIN #ADDR 

where ADDR is the address of the first byte in the 5-byte string of 

Assembly Language Expansion : 

MOV #ADDR,-(SP) 

MOV #2,-(SP) ;MOVE CALL CODE ONTO STACK 

EMT 42 

Global Name ; CVT 

Description : The 5-byte string of 7- or 8-bit decimal ASCII 
characters Vrhich c^-f-aT^-f- a-i- arini? av^s /-i/-->->-iTT£iV'-i-Q/-i -in-t-/^ -t-ViQ-iv Vx-i -m^v-tt gmi-iTT 

alent. The converted value is returned to the top of the stack, 
right- justified, followed by the address of the byte which follows 
the last character converted. The largest decimal number that can be 
converted is 65,535 (2 -1). The user must clear the stack. 

Errors : The conversion will be stopped if an error condition 

is encountered. The user will be informed of the type of error via 

the condition codes in the Processor Status register. 

C-bit set means that a byte was not a decimal digit. 
V-bit set means that the decimal number was too large, 
i.e., greater than 65535. 

The value returned will be correct up to the last valid byte. The 

address returned will be that of the invalid byte. If the conversion 

is satisfactory, the condition codes will be cleared. 
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.BIN2D 

3.8.5.4 .BIN2D - Convert one binary word into five decimal ASCII 
characters. 

Macro Call : .BIN2D #ADDR,WORD 

where ADDR is the address of the first byte of the buffer where the 

characters are to be placed, and WORD is the number to be converted. 

Assembly Language Expansion : 

MOV WORD,-(SP) 

MOV #ADDR,-(SP) 

MOV #3,-(SP) ;MOVE CALL CODE ONTO STACK 

EMT 42 

Global Name : CVT 

Description ; WORD is converted into a string of five decimal 
7-bit ASCII characters which are placed into consecutive bytes start- 
ing at location ADDR. They are right- justified with leading zeros. 
The stack is cleared. 

Errors: No errors are possible. 
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.02BIN 

3.8.5.5 .02BIN = Convert six octal ASCII characters into one 
binary word. 

Macro Call ; .d2BIN #ADDR 

where ADDR is the address of the first byte in the 6-byte string of 

o ctal characters to be conver ted. 

Assembly Language Expansion : 

MOV #ADDR,-(SP) 

MOV #4,-(SP) ;MOVE CALL CODE ONTO STACK 

EMT 42 

Global Name : CVT 

Description : The 6-byte string of 7- or 8-bit octal ASCII char- 
acters which starts at ADDR is converted into the binary member 
equivalent. The converted value is returned to the top of the stack, 
right-justif ied, followed by the address of the byte which follows 
the last character converted. The largest octal number which can be 
converted is 177777. The stack must be cleared by the user. 

Errors; The conversion will be stopped if an error condition 

is encountered, and the user will be informed of the type of error 

via the condition codes in the Processor Status register: 

C-bit set means that a byte was not an octal digit. 
V-bit set means that the octal number was too large, 
i.e., the first byte was greater than 1. 

If the conversion has been satisfactory, the condition codes are 

cleared. Following C- or V-bit errors, the value returned will be 

correct up to the last valid byte. The address returned will be that 

of the first invalid byte. 
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.BIN20 

3.8.5.6 . B_IN20 - Convert one binary word into six octal ASCII 
characters. 

Macro Call : .BIN20 #ADDR,WORD 

where ADDR is the address of the first byte of the buffer into which 
the six octal ASCII characters are to be placed, and WORD is the 
binary number to be converted. 

Assembly Language Expansion : 

MOV WORD,-(SP) 
MOV #ADDR,-(SP) 
MOV #5,-(SP) 
EMT 42 

Global Name : CVT 

Description : The WORD is converted into a 6-byte string of 7-bit 
octal ASCII characters, right- justified with leading zeros, which is 
placed into the buffer addressed by ADDR. The stack is cleared. 

Errors : No errors are possible. 
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3.8.6 Requests for Interfacing with the Command String Interpreter 

A user program may obtain dataset specifications via keyboard 
input at run time by calling the Command String Interpreter (CSI) 
routine. This routine is used by many system programs; it accepts 
keyboard input at program run time in the format presented in 
Appendix K. 

The CSI is called in two parts, by two different requests: 

.CSIl condenses the command string and checks for 
syntactical errors. 

.CSI2 sets the appropriate Link Block and Filename 

Block parameters for each dataset specification 
in the command string. 

Each command string requires one .CSIl request for the entire command 

string, and one CSI2 request for each dataset specifier in the 

comm and s tr i ng . 

The user must first set up a line buffer in his program and 
read in the command string. Then he does a .CSIl, which condenses 
the string by eliminating spaces, horizontal TABs, nulls, and RUBOUTs , 
sets pointers in a table to be referenced by .CSI2, and checks the 
command string for syntactical errors. If there are no errors, the 
.CSI2 request may be given once for each dataset specification that 
the user expects to find in the command string. .CSI2 fills in the 
appropriate Link Block and Filename Block parameters according to the 
device name, filename, extension, UIC, and switch entries in the 
c ommand s tr ing . 
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3.8*6.1 .CSIl - Condense coitimand string and check syntax. 

Macro Call : .CSIl #CMDBUF 

where CMDBUF is the address of the command buffer header described 

under "Rules" below. 

Assembly Language Expansion : 

MOV #CMDBUF,-(SP) 
EMT 56 

Global N^e : CSX 

Description ; Condenses the command string by removing spaces, 
horizontal TABs, nulls, and RUBOUTs, and checks the entire command 
string for syntactical errors. Control is returned to the user with 
a at the top of the stack if the syntax is acceptable, or with the 
address (in the command string line buffer) of the data byte at which 
the scan terminated because the first error was encountered. 

Rules : The .GSI2 request must be preceded by a .CSIl request, 

because .CSI2 assumes it will get a syntactically correct command; 
more than one .CS12 request can follow a single .CSIl request. 

The user must set up a line buffer and read in the command string 
before doing .CSIl. Command Strings must not be read in dump mode. 

It is the user's responsibility to print a # on the teleprinter 
to inform the operator that a CSI format is expected (Section 2.1). 
If VERTICAL TAB is used as the terminator, the # will be typed 
immediately without a carriage return or line feed. 

The user must set up a seven-word command buffer header in his 
program immediately preceding the header of the line buffer into whicn 
the command is to be read. The user is not required at this time to 
set up anything in the command buffer header prior to calling .CSIl; 
it will be used as a work-and-communication area by the Monitor 
routines which process the .CSIl and .CSI2 requests. 

The user must clear the stack upon return from the Monitor. If 
the top of the stack f (i.e., if there was a syntax error), .CSI2 
must not be called. 

Example ; See .CSI2, Section 3.8.6.2. 
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.CSI2 

3,8.6.2 .CSI2 - Interpret one dataset specification of a command 
string. 

Macro Call : .CSI2 #CSIBLK 

where CSIBLK is the CSI control block, described under "Rules" below. 

Assembly Language Expansion : 

MOV #CSIBLK,-(SP) 
EMT 57 

Global Name ; CSM 

Description : Gets the next input or output dataset specification 
from the command string, and sets the PHYSICAL DEVICE NAME entry in 

name Block, and any switch entries in an extension of the Link Block. 

Rules : Before calling .CSI2, the user must: 

• Call .CSll to condense the command string and check it for 
syntax errors. There must have been no syntax errors. 

• Set up a CSI control block as follows: 
CSIBLK: 



POINTER 


TO 


CMDBUF 


POINTER 


TO 


LNKBLK 


POINTER 


TO 


FILBLK 



where POINTER TO CMDBUF is the address of the 7 -word work 
area preceding the command string line buffer header; 

POINTER TO LNKBLK is the address of the Link Block of the 
dataset whose specification is being requested; and 

POINTER TO FILBLK is the address of the Filename Block of 
the dataset whose specification is being requested 
(currently, CSI allows only one file per dataset specifi- 
cation) , 

Set the first word (Code Word) of CMDBUF to either or 2. 
means "get next input dataset specification" , and 2 means 
"get the next output dataset specification". .CSI2 does not 
check the validity of the code word. 

Initialize the NUMBER OF WORDS TO FOLLOW entry in the Link 
Block to contain the number of words to follow. This must 
be at least one, because .CSI2 will alter the following 
word, i.e., the PHYSICAL DEVICE NAME word. .CSI2 does not 
check the validity of this byte. 

The user may specify any number from 1 to 255io i^ this 
location. All words in excess of 1 are used for switch 
space (see the interface with respect to switches, de- 
scribed below) . 
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.CSI2 (cont) 



Upon return from the .CSI2 request, the Monitor will have provided the 
following information: 

• The top of the stack contains two items of information. 
Bits 1-0 have the following meaning: 

a. 0, which means the dataset specification requested has 

been obtained, and there are still more dataset 
specifications of the type requested (i.e., input 
or output) ; or 

b. 1, which means the dataset specification requested has 

been obtained, and there are no further dataset 
specifications of the type requested; or 

c. 2, which means (a) , but this particular dataset specifi- 

cation included more switches than would fit in the 
space provided; or 

c. 3, which means (b) , but this particular dataset specifi- 
cation included more switches than would fit in the 
space provided. 

If there are no more dataset specifications and the user 
requests one anyway, a null specification will be returned. 

Bit 2, when set to one, indicates that the device name in 
the Link Block is a default supplied by the system (see 
Section 3.4.1) . 

• With respect to values returned in the Link Block (Figure 3-6) 

If the PHYSICAL DEVICE NAME word is zero, the user does not 
wish this particular output (input) dataset to be generated 
(read); i.e., this entry was omitted when the command 
string was typed. If not zero, the PHYSICAL DEVICE NAME and 
UNIT NUMBER are appropriately set to the device and unit 
specified in the command string. 

• Immediately following the PHYSICAL DEVICE NAME word in the 
Link Block are the switches specified in the command string. 
The interface for each switch is shown in the switch block 
below. These switch blocks are written in the area provided 
by the programmer in the Link Block. Note that the number 
of words to follow in the switch block is not the same 
quantity as is specified in the LINK Block. 



NUMBER OF WORDS TO FOLLOW 



POINTER TO FIRST CHARACTER OF Vn 



POINTER TO FIRST CHARACTER OF Vn-1 



POINTER TO FIRST CHARACTER OF VI 



W(ASCII) 



S (ASCII) 



;for /SW 
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T -P ATTTHjT 



NUMBER OF WORDS TO FOLLOW is zero, there are no more 
switches. Note that the pointers are in reverse order. 
After the value pointers are the ASCII bytes which contain 
the first two characters of the switch. The first character 
is in the low byte, and the second is in the high byte. If 
the name of the switch contains only one character, the 
ASCII representation of that character will be in the low 
byte, and the high byte will contain a zero. Note that if 
the NUMBER OF WORDS TO FOLLOW is not zero, it is the niomber of 
values -i-T. For example.- if >he switch /SWITCH : $ 12 :^B is 
stored in memory beginning at location 1000 as: 

1000 1001 1002 1003 1004 1005 1006 
/SWITCH 



1007 



1010 
$ 



1011 
1 



1012 
2 



1013 



1014 
A 



1015 
B 



then the completed interface appears as: 



3 


1014 


1010 


127- 


=W 123= 


= S 



• with respect to the values returned in the Filename 
Block (Figure 3-7): 

a. The FILENAME occupies the two words at FILBLK and 
FILBLK+2. If the Monitor returns zero at FILBLK, no 
fileneime was specified in the dataset specification; 
if it returns 523 at FILBLK, * was specified as the 
filename. Otherwise, the Monitor returns at FILBLK 
and FILBLK+2 the first six characters of the filename 
specified, in Radix-50 packed ASCII. 

b. The EXTENSION occupies the word at FILBLK+4. If the 
Monitor returns zero at FILBLK+4, no extension was 
specified; if it returns 52g, * was specified. Other- 
wise, the Monitor returns the first three characters of 
the extension specified, in Radix-50 packed ASCII. 

c. The USER IDENTIFICATION CODE occupies the word at 
FILBLK+6. If the Monitor returns zero at FILBLK+6, no 
UIC was specified in the dataset specification (the I/O 
processors will assume the UIC of this user) . If a UIC 
was typed in, the Monitor will set this word appropriately. 
The Monitor returns 377 g in the high- or low-order byte 

of this word if * was specified in either of those positions 

The user may restart at the beginning of the input data- 
set or output dataset side of the command string simply 
by recalling .CSIl and issuing a or 2 code, respec- 
tively. Note that he may not restart one without re- 
starting the other. 

Remark : There is no error checking with respect to magnitude 
when the UNIT or UIC values are converted from octal ASCII to binary. 
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LINK Block 

3.9 USER PROGRAM TABLES AND CONTROL BLOCKS 

3.9.1 The Link Block (used for all input/ output and directory requests) 



LNKBLK; 



ERROR RETURN ADDRESS 



000000 LINK POINTER (for Monifor use only) 



LOGICAL NAME OF DATASET ~ Radix-50 Pocked ASCII 



UNIT NUMBER 



NUMBER OFWORDS TO FOLLOW 



PHYSICAL DEVICE NAME ~ Radix-50 Packed ASCII 



Figure 3-6 The Link Block 

Each dataset in a user's program must have a Link Block associated 
with it. Entries in the Link Block which must be specified by the 
user can be written into his program or set by the program itself 
before the dataset is INITed. Each entry is explained below. 



Address 



Name 



Function 



LNKBLK- 2 



ERROR RETURN 
ADDRESS 



LNKBLK 



LINK POINTER 



LNKBLK+2 



LOGICAL NAME 
OF DATASET 



LNKBLK+4 



NUMBER OF 
WORDS TO 
FOLLOW 



This entry must be set by the user to 
contain the address where he wants to trans- 
fer control in the event that any request 
associated with this dataset fails to 
obtain required buffer space from the 
the Monitor. If no address is speci- 
fied here, such an error will be treated 
as fatal. This address may be changed 
by the user's program at any time. 

This location must be set to zero by 
the user and must not be modified by 
him. The Monitor places a linking ad- 
dress here when the dataset is INITed. 
Before INITing a dataset, the Monitor 
tests this pointer for zero. If it is 
not zero, the Monitor assumes that the 
dataset was already INITed. 

The user can specify a name for the dataset 
in this entry. This name, which must be 
unique, is used to associate the dataset 
with a device which is specified by an 
ASSIGN from the keyboard. The name is 
stored in Radix-50 packed ASCII by the 
.RAD50 assembler directive. This speci- 
fication is optional, but if it is omitted, 
the ASSIGN command cannot be used. 

This byte contains the count of the number 
of words to follow in the Link Block. The 
user should set it to a if he does not 
specify any PHYSICAL DEVICE NAiME in the 
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Address 



Name 



Function 



next word, or to a 1 if he does. Values 
greater than 1 may be used if the Com- 
mand String Interpreter is to be called. 

LNKBLK+5 UNIT NUMBER This code specifies the unit number of the 

device linked to tlie d a t a s^e^^ For ex amo 1 e , 
the TCll Controller (DECtape) can drive up 
to eight tape drives (units) , numbered 
0-7. 



LNKBLK+6 



PHYSICAL 
DEVICE NAME 



If the user specified 1 or greater in byte 
LNKBLK+4, he may specify here the standard 
name (Appendix A) for the device associated 
with the dataset in Radix-50 format. If no 
name is specified here, the user must specify 
LOGICAL NAME OP DATASET and perform an 
Assign command before he runs his program. 
If physical device name is specified 
both here and in an ASSIGN command, the 
device specified in the ASSIGN command 
overrides the value given here. 



LNKBLK+8 

through 

LNKBLK+n 



OPTIONAL 
DATA 



Present only if LNKBLK+4 is greater than 1. 
It is used to pass additional information 
such as switch information when using the 
Command String Interpreter or Resident 
EMT information when using .RUN, via the 
Link Block. 
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FILENAME Block 

3.9.2 The Filename Block - Each file associated with a dataset 
must be described by the user in a Filename Block. If a dataset is 
not a file, the Filename Block must still be used (if .OPEN is used) 
but FILENAME, EXTENSION, AND PROTECT need not be specified. The file- 
name Block is used by OPEN and all directory management requests. 



FILBLK: 



ERROR RETURN ADDRESS 



ERROR CODE 



HOW OPEN 



RLE 



NAME 



FILE 



NAME 



EXTENSION 



USER ID CODE 



(spare) 



PROTECT CODE 



Figure 3-7 The Filename Block 



Address 



Name 



Function 



FILBLK- 4 



ERROR RETURN ADDRESS 



The user must specify here the 
address to which he wants the 
Monitor to return control if one 
of the errors in Table 3-4 occurs 
during an operation involving the 
file. If no address is specified 
here, any such error will be trea- 
ted as a fatal error. 



3.9.2.1 Error Condition Codes (FILBLK-1) 

Table 3-4 
Filename Block Error Conditions 



Error Code 

In File- 
name Block 



Faulting 
Request 



Cause 



Remedy 



00 


.OPENC 
. OPENE 
.OPENI 
.OPENO 
.OPENU 


An attempt was made 
to open a dataset 
that was previously 
opened. 




01 




unused 





(continued on next page) 
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Table 3-4 (Cont) 
Filename Block Error Conditions 



Error Code 
In File- 
name Block 



FaUrlting 
Request 



Cause 



Remedy 



02 


.OPENO 


An attempt was made 


If name of file was 






uO Opdi CI J-J.-1.C; 


~~rr"Ct delete the 






which already 


file (with PIP) or 






exists. 


change file name. 


.OPENC 


An attempt was made 






.OPENE 


to open a file 






.OPENI 


for input, exten- 






. OPENU 


sion, or update 
which is currently 
opened for output, 
or which does not 








exist. 




oRUN 


The file specified 








was already OPENed 








for output, or the 








file does not exist. 




03 


.OPENC 


An attempt was made 


Close file. 




.OPENE 


to open a file which 






.OPENI 


has already been 






. OPENU 


opened the maximum 
number of times 








(76g). 




04 


. OPENC 


An .OPENC, .OPENE, 


.CLOSE the previous 




.OPENE 


or .OPENU attempt 


open. 




.OPENU 


was made to open a 
file which has al- 
ready been opened 
for either .OPENC, 








. OPENE , or . OPENU . 




05 


. OPENE 


Illegal request to 
a contiguous file. 




06 


. OPENC 


An attempt was made 


Resolve access pro- 




. OPENE 


to access a file 


blem with owner of 




.OPENI 


which the protection 


the file. 




.OPENO 


code prohibits. 






.OPENU 








.RUN 






07 


. OPENC 


Illegal OPEN re- 
quest to a contigu- 








ous file. 




11 


. OPENC 


File opened for 


Close offending file. 




.OPENE 


output or extension 






. OPENO 


is already on cur- 






. OPENU 


rent DECtape unit. 




12 


.ALLOC 


Directory full (DT). 


Mount another DEC- 




. OPENO 




tape. 



(Continued on next page) 
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Table 3-4 (Cont) 
Filename Block Error Conditions 



Error Code 

In File- Faulting 

name Block Request 



Cause 



Remedy 



13 


.ALLOC 


The UIC was not 
entered into the 
device MFD. 


Enter UIC via PIP. 


14 


. APPND 


An attempt was made 


Wait until file is 




.DELET 


to perform an 


closed. 




.REN AM 


illegal operation 
on an opened file. 




15 


.ALLOC 


An attempt was made 


Change file name. 




•OPENO 


to create a file 
with an illegal 








file name. 




16 


.RUN 


All datasets were 


Release all datasets 






not released prior 


which were INITed. 






to issuing the re- 








quest. 




17 


.RUN 


Load module format 


File must be linked 






error . 


into a load module. 


20 


.RUN 


Specified CIL entry 


Add proper entry to 






not found. 


CIL or use correct 
name. 


21 


• RUN 


No transfer address 


Check for END state- 






or illegal trans- 


ment in source pro- 






fer address. 


gram, or use correct 
/TR when linking. 


22 


.RUN 


Stack base entry in 


Probably a program 






the System Vector 


error . 






Table (SVT) is 








below the Stack 








Pointer. Stack can- 








not be moved as 








requested in the 








call. 




23 


.RUN 


Module is outside 


Relink to within 






the boundaries 


boundaries. Ensure 






of the allowable 


that resident portion 






load area. 


of program is not 
being overlayed. 
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Address 



Name 



Function 



FILBLK-2 



HOW OPEN 



This is set when the .OPENx macro's 
assembly language expansion is executed. 
It tells the Monitor which kind of open 
is being requested: .0PENU=1, .0PEN0=2, 
.0PENE=3, .0PENI=4, .0PENC=13. 



_FILBLK-1 ERROR CODE This entry should not be set by the user^ 

It will be set by the Monitor to indicate 
the type of error (Table 3-4) which 
occurred. It will be cleared of any 
previous condition at each .OPEN call. 



FILBLK+0 
FILBLK+2 



FILBLK+4 



FILBLK+6 



FILE NAME 



EXTENSION 



This two-word entry must be specified by 
the user if this dataset, or a portion 
thereof, is a file. It is the name of 
the file, in packed Radix-50 format. 

named in the previous entry has an ex- 
tension. It is in packed Radix-50 format. 

USER I.D. CODE The user may enter his USER ID CODE here 
in octal: 



GROUP NUMBER 



USER'S NUMBER 



High-Order Byte 



Low-Order Byte 



If no entry is specified here, the 
current user's UIC is assumed. 



FILBLK+10 



PROTECT 
CODE 



The user may specify here the protection 
to be given to the file at its creation 
or renaming (see following paragraph) . 
If 0, a default protection 233 will be 
allotted. 
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3.9.2.2 The File Protection Codes 



7 


6 


5 


4 


3 


2 


1 





Owner 


User Group 


All Others 



Owner: Bit 6=1= Owner cannot write on or delete the 

file. This is a safeguard to prevent 
inadvertent deletion or over-writing. 

Bit 7=1= Protect the file from automatic deletion 
on Finish. 



Figure 3-8 File Protection Codes 



User Group and All Others 

Function 



Code 


Delete 


Write 


Read 


Run 




1 


yes 


yes 
yes 


yes 
yes 


yes 
yes 


2 or 3 
4 or 5 






yes 


yes 
yes 


6 or 7 











Note; yes indicates that the operation is allowed. For 
example, if a file belongs to user [23,10] , a pro- 
tection code of 3 will allow user [12,4] to read or 
run but not delete or write on it. 

Figure 3-8 File Protection Codes 
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3.9.3 The Line Buffer Header - (used by READ and WRITE requests) 



BUFHDR: 



MAXIMUM BYTE COUNT 



STATUS 



MODE 



ACTUAL BYTE COUNT 



POINTER (Dump Mode only) 



Figure 3-9 Line Buffer Header 
Each element of the line buffer header table is as follows: 
Address Name Function 



BUFHDR 



BUj:?HDk+2 



BUFHDR+3 



BUFHDR+4 



BUFHDR+6 



MAXIMUM BYTE 
COUNT 



MQDt: 



STATUS 



ACTUAL BYTE 
COUNT 



The count shows the size of the buffer, 
in bytes. It must be specified here by 
the user on all INPUT operations. 

The user specifies here the mode of the 
transfer. All modes are listed and ex- 
plained in Figure 3-10. 

The Monitor will place in this byte the 
status of the transfer when control is 
returned to the user. Figure 3-11 lists 
each bit and its meaning. Errors encoun- 
tered executing an I/O transfer will be 
flagged in this byte. The user should 
always check its content after each trans- 
fer completes. 

This count controls the number of bytes to 
be transferred on OUTPUT. It must be 
initialized by the user before any output 
transfer from the line buffer. After any 
transfer in or out, it will show how 
many bytes have been transmitted (or in 
some modes, see Section 3.6, would have 
been transferred had some error not been 
detected) . 

If bit 2 of MODE is 1, the user specifies 
here the starting address of the line 
buffer. If bit 2 of MODE is 0, the line 
buffer header is only three words in length, 
and must immediately precede the line 
buffer itself. (Section 3.9.6 Note 9.) 

NOTE 

The Monitor will return control to the program 
if a device transfer is needed to satisfy a READ 
or WRITE request. During this time, the header 
words will be used to store data relevant to the 
operation underway. The user should not, there- 
fore, attempt to change this content until it is 
evident that the transfer has been completely 
effected, e.g., after a .WAIT return. 



POINTER 
(dump mode) 
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Spare 



Set to 1 to suppress 
automatic echo on 
a terminal (keyboard) 
device. 



Reserved 
for 
RSX 



to. 



= Normal 

1 = Special 



ASCII 
1 = Binary 

= Formatted 

1 = Unformatted 

= Data follows Header 

1 = Dump 

'■ No Pal-ity 
Parity (indirect) 



Figure 3-10 The Mode Byte 

3.9.3.1 The Transfer Modes - The user can specify ASCII or binary 
data in nine different modes of transfer: 

ASCII Modes: Formatted ASCII Parity - Special 
Formatted ASCII Parity - Normal 

Formatted ASCII Nonparity - Special 
Formatted ASCII Nonparity - Normal 

Unformatted ASCII Parity - Special 
Unformatted ASCII Nonparity - Normal 

Binary Modes: Formatted Binary - Special 
Formatted Binary - Normal 

Unformatted Binary - Normal 

1. Formatted ASCII Norma l - Data in this mode is assumed by 

the Monitor to be in strings of 7-bit ASCII characters termi- 
nated by LINE FEED, FORM FEED, or VERTICAL TAB. 

READ: The line buffer is filled until either a terminator 
is seen or the number of bytes transferred becomes 
equal to the MAXIMUM BYTE COUNT. If the MAXIMUM 
BYTE COUNT is reached before the terminator is 
seen, the invalid line error bit in the Status 
Register of the buffer header is set, and each re- 
maining character through to the terminator is read 
into the last byte of the line buffer, i.e., the 
surplus bytes are overlayed. After the transfer, 
the actual byte count is set to the number of bytes 
read (including the excess) . RUBOUTs and NULLs are 
discarded. The terminator is transferred. LINE 
FEED is supplied after RETURN. 

WRITE: The line buffer is output until the number of bytes 
transferred equals the ACTUAL BYTE COUNT. If the 
last character is not a terminator, the invalid line 
error bit is set in the STATUS BYTE of the buffer 
header. Previous terminators are output as normal 
characters. 
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For non file-structured devices, TABs are automaticallY followed 
by RUBOUTs; FORM FEEDS are automatically followed by NULLs. 

The READ/WRITE processor passes data to the device driver 
specified, and each driver will convert the information to 
meet its specific needs. Appendix G summarizes the charac- 
teristics of the device drivers. Normally, output is deferred 
until the current buffer is full or until a .CLOSE or .RLSE 
occurs. However, for terminal devices, the buffer is written 
when a line terminator is seen. VERTICAL TAB plays a special 
role here, since it is a terminator but does not cause a 

2. Formatted ASCII Special - 

READ : The same as formatted ASCII normal with this ex- 
ception: if the MAXIMUM BYTE COUNT is reached be- 
fore the terminator, the transfer is stopped. 
The remaining characters are not overlaid, but are 
retained for transfer at the next .READ . An invalid 
line error will be returned in the STATUS BYTE, and 
ACTUAL BYTE COUNT will equal MAXIMUM. 

WRITE : The same as formatted ASCII normal with this excep- 
tion: the line buffer is output until the first 
terminator; the ACTUAL BYTE COUNT will stop the 
transfer if it is reached before the terminator is 
seen. In this case, the invalid line error bit is 
set in the STATUS BYTE. Note that in this mode only 
one line of data can be output at once, but its 
byte count need not be exactly specified, provided 
it is not greater than the ACTUAL BYTE COUNT. 

3 . Formatted Binary Norma l - 

READ: This is an 8-bit transfer. Words 2 and 3, STATUS/ 
MODE, and ACTUAL BYTE COUNT always accompany 
the data during formatted binary transfers. The 
counts are adjusted by the Monitor to include the 
extra words. On input, the line buffer is filled 
until the number of characters transferred equals 
the ACTUAL BYTE COUNT read, or the MAXIMUM BYTE 
COUNT. If the MAXIMUM is reached before the ACTUAL, 
an invalid line error occurs and the remaining 
bytes are overlaid into the last byte until the 
checksum is verified. After the transfer, the 
ACTUAL BYTE COUNT contains the actual number of data 
bytes read (including the excess) . 

WRITE : This is an 8-bit transfer. Words 2 and 3 of the 
line buffer header are output, and data is trans- 
ferred until the niomber of characters transferred 
is equal to the ACTUAL BYTE COUNT; then a checksum 
is calculated. The checksum is output at the end. 
The byte count is adjusted to reflect the presence 
of words 2 and 3 from the line buffer header. 



READ ; The line buffer is filled until the number of charac- 
ters transferred equals the ACTUAL BYTE COUNT read. 
If the MAXIMUM COUNT is reached before the ACTUAL, 
the remainder of the line is retained by the Monitor 
The MAXIMUM BYTE COUNT is transferred to the line 



3-89 



buffer and the ACTUAL BYTE COUNT is set to the full 
input count, rather than to the number of bytes 
actually transferred. The invalid line error will 
be set in the STATUS BYTE. The user can compare 
the MAXIMUM COUNT with the ACTUAL, determine how much 
data remains, and recover it by an unformatted binary 
read (allowing 1 extra byte for the checksum) . 

WRITE ; Identical to formatted binary normal 

5. Unformatted ASCII Normal or Special - This mode is available 
to the user who wants to do his own formatting. Seven bits 
are transferred; the eighth is always set to zero. NULLs 

are discarded. 

READ : Transfer stops when the number of bytes transferred 
reaches the MAXIMUM BYTE COUNT. Nulls are discarded 
but all other characters are treated as valid. 

WRITE: All characters are transferred. The transfer stops 
when the ACTUAL BYTE COUNT is reached. 

6. Unformatted Binary Normal or Special - This mode is identi- 
cal to unformatted ASCII except that eight bits are transferred 
on both input and output and nulls are not discarded. No 
checksum is calculated. 

7. Formatted ASCII Parity - Identical to formatted ASCII 

(Special or Normal) except that even parity is generated in 
the eighth bit on OUTPUT; during INPUT it will be checked. 
Valid characters will be passed to the user as 7 bits; 
invalid characters will be marked by bit 8=1, and will 
cause the setting of the parity error bit in the STATUS BYTE. 

8. Unformatted ASCII Parity - Identical to unformatted ASCII 
(Special or Normal) except that eight bits are transferred 
instead of seven. No parity generating or checking is per- 
formed. 

9'* Indirect Modes - All modes can be specified as indirect, 
which means that the word after the ACTUAL BYTE COUNT is 
considered to be a pointer to the beginning of the data 
rather than the beginning of the data proper. (Section 
3.9.4.) This is referred to as DUMP mode. 
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3.9.3.2 The Status Byte 



End of medium 

(EOM) or 
End of fiie 

(EOF) 



1 I 



' — Invalid line error 

' Checksum error 

Character pariiy error or 
il legal binary format 



Don ^v 



Soor e 



flag 



Figure 3-11 Status Byte Format 
The function of each status format bit is explained below, 



Bit 


Mode 


Request 




ALL 


. READ/WRITE 





FORMATTED 


.READ 


(INVALID 


ASCII NORMAL 




LINE) 


(parity or 
non-parity) 


.WRITE 




FORMATTED 


.READ 




ASCII 






SPECIAL 






(parity or 






non-parity) 





(CHECKSUM 
ERROR) 



FORMATTED 

BINARY 

NORMAL 



FORMATTED 

BINARY 

SPECIAL 



ALL 

UNFORI-IATTED 
MODES 



FORMATTED 
BINARY 



WRITE 



READ 



.READ 



READ 



READ 



Condition 



Appropriate BYTE COUNT = 



The MAXIMUM BYTE COUNT ran 
out before a line terminator 
was seen. (Last byte has 
been overlaid until the termi- 
nator has been reached.) 

The last byte was not a 
i_eirmina uor . 

The MAXIMUM BYTE COUNT was 
reached before a line 
terminator was seen (excess 
data has not yet been read) . 

The ACTUAL BYTE COUNT was 
reached before any terminator 
was seen. 

The MAXIMUM BYTE ran out 
before the count stored with 
the data. (The last byte 
has been overlaid in order 

to verify the checksum. ) 

The MAXIMUM BYTE COUNT was 
reached before the count 
stored with the data. (The 
excess data still remains to 
be read and checksum has 
not been verified.) 

BYTE COUNT = the actual number 
of bytes transferred. The 
reason BYTE COUNT < MAXIMUM 
BYTE COUNT is that an EOF or 
EOM has been encountered before 
the buffer was full. Bit 6 
will also be set. 

There was a discrepancy be- 
tween the checksum accumulated 
during the .READ, and that 
stored with the incoming data. 
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(PARITY 
FORMAT) 



FORMATTED 
ASCII PARITY 
NORMAL OR 
SPECIAL 



READ 



A character was read which had 
odd parity. The eighth bit of 
the illegal character delivered 
is set to a 1. The transfer 
continues. If this bit is set 
the user need only check each 
character returned during proc- 
essing of the buffer for bit 8 
set to locate the character re- 
turned with wrong parity. 



(ILLEGAL 
BINARY 
FORMAT ) 



FORMATTED 
BINARY 



READ 



This bit is set if a line proc- 
essed in a binary mode does not 
have a 001 in the first word. 
The first word is ignored, i.e.^ 
no data is returned to the buf- 
fer. Subsequent reads access 
successive lines and return 
error bits or data as appro- 
priate. 



(EOM/EOF) ALL MODES 



.READ or 
.WRITE 



An input device cannot supply 
any more data or an output de- 
vice cannot accommodate more, 
i.e., the disk has no more 
storage space, or the paper 
tape reader has run out of 
paper tape. No data is re- 
turned on .READS unless bit jE) 
is also set (see bit jEl) . On 
.WRITES an unspecified por- 
tion of the buffer may have been 
written (enough data to fill a 
partially filled monitor buffer 
may have been transferred to 
the buffer and written before 
the EOM or EOF was detected) . 
Subsequent requests return to 
user with this bit set. 



(DEVICE 
PARITY) 



ALL MODES 



, READ or 
. WRITE 



A hardware error has been de- 
tected on a bulk storage device. 
This could be either a parity 
error or a timing error. The 
driver will already have tried 
to READ or WRITE 8 or 9 times 
before setting this bit. (This 
flag is a warning that the data 
in this line or some subsequent 
line still using data from the 
same device block may be invalid 
It will be returned for each 
transfer call using the same 
block.) 
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3.9.4 The RECORD Block 



RECORD Block 



ADDRESS 



RECBLK 



RECBLK: 



FUNCTION / STATUS 



BUFFER ADDRESS 



RECORD LENGTH 



HI ORDER. RECORD # j 



X3 

Figure 3-12 The Record Block 
FUNCTION 

FUNCTION / STATUS WORD 



BIT 



- 

1 - 



RECBLK+2 



RECBLK+4 



RECBLK+6 
RECBLK+1J3 



Not used 

Record Output - Set by user 

R^ 






3-8 - Not used 

(Following bits set by Monitor) 

9 - Illegal Function 

10 - File is linked or device is not File structured. 

11 - Record requested lies outside the file. 

12 - File not OPEN 

13 - Protect code violation. Incorrect Open 

14 - Not used 

15 - Device parity error 

The user may set only bits 1 or 2; error bits are set 
by the Monitor, and should be tested for by the user 
upon return from the request. The error bits are 
cleared by the Monitor when a .RECRD request is issued 
and are set as appropriate upon return from the Monitor. 

BUFFER ADDRESS 

The address of the user's buffer. The buffer must 
be larg^e enough to contain a record of the length 
indicated in the next v;ord, as the Monitor assumes that 
sufficient space is available and will overlay data 
stored below a buffer of insufficient length. 

RECORD LENGTH 

The number of bytes of a Record. This value, which 
must remain the same for all records in the file, is 
supplied by the user. 

High Order - Record Number 
Low Order - Record Number 

This entry identifies the record to be read or 
written. Two words are provided in anticipation of 
files with more than 65,53 6 records. 

First Record of File is number 0. 
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BLOCK Block 

3.9.5 The BLOCK Block - (used by BLOCK request only) 



BLKBLK: 



FUNCTION/STATUS 



BLOCK NUMBER 



MEMORY BUFFER ADDRESS 



LENGTH 



Address 



BLKBLK 



Figure 3-13 The BLOCK Block 
Name Function 



FUNCTION/STATUS 



BLKBLK+2 



BLKBLK+ 4 



BLKBLK+6 



BLOCK NUMBER 



MEMORY BUFFER 
ADDRESS 



User specifies here the function to be 
performed, and the Monitor returns to 
the user with the appropriate status bits 
set. 



Bit 

f 
u 
n 
c 
t 
i 
o 
n 



Bit = 1 means : 

function is GET 

1 function is OUTPUT 

2 function is INPUT 
3-8 reserved 

9 illegal function 

10 file is linked, or device is 
not file structured 

11 block number does not exist 
in file, i.e., it is greater 
than the file length 

12 file not open 

13 protect code violation 

14 end of data error 

15 device parity error 



LENGTH 



Requested block number to be transferred 
relative to the beginning of the file. 

First block of file is 0. 

The address of the buffer (supplied 
by the Monitor on INPUT or GET func- 
tions) . 

The length of the buffer in words. 
BLKBLK+6 is set by the Monitor on 
INPUT or GET functions . 
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TRAN Block 



3.9.6 The TRAN Block (used by TRAN request only) 
TRNBLK: 



DEVICE BLOCK NUMBER 



MEMORY START ADDRESS 



POSITIVE WORD COUNT 



FUNCTION/STATUS 



NUMBER OF WORDS NOT TRANSFERRED 



Figure 3-14 The TRAN Block 
The user must set up a TRAN block for each .TRAN in his program. 



Address 



TRNBLK 



TRNBLK+2 



TRNBLK+4 



TRNBLK+6 



Name 

DEVICE BLOCK 

NUMBER 



BUFFER 
ADDRESS 

WORD COUNT 



Function 

User specifies here the absolute block num- 
ber of the device, at which the transfer is 
to begin. Block J0 is the first block on 
bulk storage devices. If it is not a bulk 
storage device, specify block 0. 

User specifies here the core memory address 
at which the data transfer is to begin. 

User specifies here the total number of 
16-bit words to be transferred. Word 
count may be more or less than block 
size. 



FUNCTION/STATUS Bit 



Bit Meaning 

Binary = 1, as opposed 

to ASCII = 
Write = 1* 
Read =1* 



6 
7 
8 
9 
10 



Reserved for Monitor's use 



11 

12 
13 

14 



DECtape direction* 

= forward 

1 = reverse 

Reserved for RSX-11 

Invalid call (improper 
function/no word count) ** 

End of medium** 



*Must be specified by user, 
**This bit is cleared by the Monitor upon .TRAN request issue and is 



set as appropriate upon return, 
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Address Name Function 

Bit Bit = 1 means : 

15 Recoverable device error 

(such as parity, timing, or 
record length)** 

TRNBLK+10 NUMBER OF User leaves this entry blank. If an 
WORDS NOT EOM occurs during the transfer, the 
TRANSFERRED Monitor will place in this entry the 

number of words not transferred. 



**This bit is cleared by the Monitor upon .TRAN request issue and is 
set as appropriate upon return. 
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Special Functions Block 

3.9.7 The Special Functions Block (used for SPEC request only) 



SPCBLK: 



WORDS TO FOLLOW 



CODE 



ADDITIONAL DATA 
WORDS AS NEEDED BY 



rUNi^iivjrN jKC^-ir'iCL'" 



Figure 3-15 

Where a special function requires supporting data the user must set 
up a Special Functions Block in his program. 



Address 



SPCBLK 



SPCBLK+1 



SPCBLK+2 



Name 



CODE 



WORDS TO 
FOLLOW 



Function 

The user identifies the function here by 
inserting the appropriate code in the 
range 0-255, q. 

The size of each Special Functions 
Block is dependent upon the Function. 
The user shows here how many more 
words belong to the particular block. 

The user places in these words data to 
be passed to the function processor or 
the function processor will return here 
such items as status information, etc. 
The format in each case is determined 
by the function. 



See Appendix J for a description of the special functions which may 
be performed for each device. 
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.RUN Block 

3.9.8 The RUN Block 

The RUN Block is used exclusively with the .RUN request. It is 

a variable length control block containing a function word and several 

parameter words. The function word is always present; any of the 

parameter words may be omitted, depending upon the settings of the 
function word. 

NOTE 

Omitting a parameter word does not mean setting 
it to zero, but rather leaving it out. Hence, 
no parameter word occupies a set position in the 
RUN Block and the block itself is of variable 
length. For reference, all words but the func- 
tion word are referred to by a letter, not by a 
number . 



Word Parameter 

1 FUNCTION WORD 

A FILE BLOCK POINTER 

B LINK BLOCK POINTER 

C NAME 

D NAME 

E LOAD ADDRESS 

F TRANSFER ADDRESS OFFSET 

G RETURN ADDRESS 



Present If: 

always 

Bit 15=0 

Bit 15=0 

Bit 15=1 or Bit 13=1 

Bit 15=1 or Bit 13=1 

Bit 3=1 

Bit 4=1 

Bit 5=1 



* Words A through G are so designated because any of 
them might be omitted under certain conditions. 

Figure 3-16 The RUN Block 



Address 



Name 



Function 



RUNBLK FUNCTION 



RUNBLK+A FILE BLOCK 



User specifies here the function to be per- 
formed (see below) . 

Address of the File Block describing the file 
which contains the load module or core image 
to be loaded. 



RUNBLK+B LINK BLOCK 



Address of the Link Block which describes 
the device from which the entity is to be 
loaded. Sufficient room must be provided in 
the Link Block to contain the EMT numbers of 
all Monitor modules which are to be loaded 
(these are contained in the load module, if 
there are any) . 
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Address 



Name 



Function 



RUNBLK+C NAME Two Radix-50 words containing either the name 

and RUNBLK+D of the specific core image to be loaded from 

a CIL (bit 13=1) or the name of the file to 
be loaded if no File Block was given 
(bit 15=1). 

R UNBLK+E LOAD AD D RE S S Specifies an address at which the e ntity is 



RUNBLK+F 



TRANSFER 

ADDRESS 

OFFSET 



CV^ iJO 



-OSGSCl , 



wx uiicu c regaj-G. l,o une JLoaQ au.-^ 



dress in the load module or CIL. 
should be position independent. 



The entity 



Specifies a value to be added to the transfer 
address obtained from the load module or CIL. 
Provides for alternate entry points to the 
module. 



RUNBLK+G TRANSFER Specifies an address to which control must be 
ADDRESS passed when loading is completed. This 

address may or may not be in the loaded entity, 



3.9.8.1 The Function Word 



15 


14 


13 


12 


Reserved for 
Expansion 


5 


4 


3 


2 


1 













V \ 




s 


/ 








\ N 


















' Reserved for Monitor 




















,,-/ 


















— Jjoad. ModuJLe/core image 










- Overlay/Program 




















Present/Not Present 












Return Address - 












Transfer Address Offset — ' 










Load Address 
















Stack Movement 


] 















Transfer of Control 

Figure 3-17 The Function Word 

Bit fi Argument Return and Transfer of Control 

=j? Indicates control is to be returned to the instruction 

following the .RUN request after completing the requested 
actions, unless bit 5=1. Regardless of the setting of bit 5, 
the load module's transfer address, size in bytes, and low 
address will be on top of the stack when bit J2f=j0 (see 
Section 3.8.1.1) . 

=1 Indicates control is to be switched to the transfer address 
of the loaded module after completion of the load, unless 
bit 5=1. Regardless of the setting of bit 5, no information 
is returned on the stack when bit ^=1, but information may 
be passed by the call to the loaded module either on the 
stack or in the general registers. 
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Bit 1 Stack Movement 

=JZI Indicates that the stack is not to be moved from its pres- 
ent position under any condition. 

=1 Indicates that stack relocation may be necessary and that 
bit 2 of this word must be tested to determine under what 
conditions relocation will be necessary. 

Bit 2 Movement Condition 

=j6 Indicates that the stack is to be unconditionally moved to 
the area directly below the module to be loaded. In this 
position the stack base entry in the System Vector Table 
(SVT) will be the same as the low address of the loaded 
module. 

=1 Indicates that the stack is to be conditionally moved, 

based on the relative positions of the stack base and low 
address of the module to be loaded. If the stack base 
entry in the SVT is higher than the low address of the 
module to be loaded, then the stack should be relocated as 
described above. If the stack base entry in the SVT is 
lower in core or equal to the low address of the module to 
be loaded, then the stack will not be relocated. 

Bit 3 Load Address 

=j3 Indicates that no optional load address is specified in the 
RUN Block. The load address information in the load 
module will be used. 

=1 Indicates that the address specified in the RUN Block is 
to be used as the load address for the requested module. 
This entry overrides the load module information. 

Bit 4 Transfer Address Offset 

=pf Indicates that no offset from the module's transfer address 
is included in the RUN Block. 

=1 Indicates that the user desires an offset, specified in 

the RUN Block, to be added to the loaded module's transfer 
address. This offset is added to the transfer address 
regardless of the setting of bit of the action word. 

Bit 5 Return Address 

=1? Indicates that no alternate return address is included in 
the RUN Block. Return of control will thus be determined 
by the setting of bit 0. 

=1 Indicates that an alternate return address has been speci- 
fied in the RUN Block and that this address will receive 
control instead of the address following the .RUN request 
or the transfer address of the load module. The setting 
of bit will still determine whether information will be 
returned on the stack. 

Bit 12 Reserved for Monitor 

This bit should always be zero. 

Bit 13 Load Module/ Core Image 

=0 Indicates that the entity being loaded is a load module. 
If the file identified by the File Block is a CIL, the 
first member of the CIL will be loaded. 
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Bit 13 (continued) 

=1 Indicates that the entity to be loaded is a member of Core 
Image Library. The File Block identifies the CIL, while 
words 4 and 5 of the RUN Block contain the name of the 
CIL member. 

Bit 14 Overlay/Program 

=p^ Indicates that an overlay is being loaded. Since this is 

a continuation of the curren t program -r datas e ts may be le#t 

open across this call. The overlay may not extend above 
the low address of the resident module, nor may it extend 
below the top of the Monitor area. System control tables 
are not refreshed as a consequence of this call. No addi- 
tional Monitor modules may be made resident. 

=1 Indicates that a new program is being loaded. This is as 

if a new program were being RUN from the keyboard. Although 
all datasets must be released by the program which called 
RUN, RUN itself will do several things to refresh the 
environment. This includes releasing Monitor modules made 
resident by the previous program, undoing dataset assign- 
ments made specifically for the previous program, loading 
any Monitor modules which should be resident for this pro- 
gram, and changing any program-related values in the SVT. 

Bit 15 File Block, Link Block 

=J0 Indicates that a Link Block and a File Block pointer are 
in the RUN Block. 

=1 Indicates that the caller has provided a short form of the 
RUN Block; the short form contains only a function word 
and a six-character filename. The Link Block and File 
Block are created by the .RUN request itself. The entity 
to be loaded must be either in the current user's area 
or in the [1,1] UIC area and must have an extension of 
LDA or null. All other function bits are ignored. The load 
module or core image (first member of CIL) is loaded at 
its normal load address, as if it were an overlay, and 
receives control at its normal transfer address. The stack 
is not moved. 

The following flowchart illustrates the effects of the various 
function word bits and their interrelationships. 
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Short 
^►•Form 



Requests 




LOAD ADDRESS IS 
AS SPECIFIED IN 
WORD E OF RUNBLK 



LOAD ADDRESS IS 

AS SPECIFIED IN 

THE LOAD MODULE 

COMD 




Load new module 



L6AD CIL MEMBER 
OR LOAD MODULE AS 
SPECIFIED IN WORDS 
C, D AND B OF THE 
RHNBLK 



LOAD FIRST CIL 
MEMBER OR LOAD 
MODULE AS SPECI- 
FIED IN WORDS A 
K R OF T^HE RUNBLKJ 



*Word A of the RUNBLK speci- 
fies a Core Image Library or 
Load Module to be loaded or 
is unspecified. If it is un- 
specified, words C and D speci- 
fy a Load Module and bit 13 
must be set. If it is speci- 
fied and bit 13 is set, words 
C and D specify a CIL member 
of the CIL specified in word 
A. 




Stack Movement 



MOVE STACK 
TO BELOW 
LOADED MODULE 



] 



TRANSFER ADDR 
= INSTRUCTION 
FOLLOWING .RUN 
REQUEST 



I 



Load new module 



SET CA = TO 
TRANSFER ADDR 
SPECIFIED IN 
LOAD MODULE IM 



DMI 
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=1? 



No 



No 



Yes 



ADD OFFSET 
SPECIFIED IN 
WORD F OF 
RUNBLK TO CA 



J 



y^ BIT 5 N 


Yes 




SET TRANSFER 
ADDR = TO WORT 
G OF RUNBLK 


\v =1? y 


?" -■ 




N. X 









J 



y^ BIT 0\ 


No 




\^ =1? y 






Y^ Yes 






y^ BIT 4\ 
<r =1? y 

N^ No 


Yes 








SET TRANSFER 


ADDRESS TO 






CA 






< 


1^ 







Overlay 




RETURN TO CMI 
FOR BEGIN OR 
REESTART 



Run 




RETURN TO KB: 
FOR BEGIN, 
REESTART OR ODT 



(SP) =TRANSFER AD 
(SP)+2 ,=MODULE SIZE 
SP)+4 =PROGRAM LOW 
ADDRESS 



i 



RETURN TO CAL- 
CULATED TRANS- 
FER ADDRESS 
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APPENDIX A 
PHYSICAL DEVICE NAMES 



Mnemonic 



Device 



DC 
DF 
DK 
DT 

LP 
MT 
PP 
PR 
PT 
CR 
SY 



RCll Disk 
RFll Disk 
RKll Disk 
DEC tape (TCll) 

Line Printer (LPll) 
Magtape (TMll) 
High-Speed Paper Tape Punch 
High-Speed Paper Tape Reader 
ASR-33 Paper Tape Device 
Card Reader (CRll) 
System Residence Device 
(DC, DF, or DK) 



014570 
014760 
015270 
016040 

n >[ o /[ o A 

046600 
052140 
063200 
063320 
063440 
012620 
075250 



Device mnemonics may be three letters on a particular 
system. The third letter is assigned if there is more 
than one controller, e.g.: 



DTA for DECtape controller 
DTB for DECtape controller 



"A" 
"B" 



The device name may be followed by an octal nvimber to 
identify a particular unit when the controller has 
several device units associated with it, e.g.: 

DTI indicates unit 1 under a single DECtape 
control, 

DTAl indicates unit 1 under controller A in 
a multicontrol situation. 



The Radix-50 equivalence is derived in accordance with the 
following formula: 



^1 ^ 50g' 



+ C2 X 50g + C3 



where Cn is a character (legal characters are space A-Z, 
$, period, and 1-9. These characters are assigned values 
from (for space) through 47 g (for 9) . 

The following program may be used to print the octal repre- 
sentation of any 3-character set Radix-5J2f equivalence. To 
exit type an illegal character. 
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APPENDIX B 
EMT CODES 



EMT 
Code 



Programmed 
Request 



Described 
on Page 





1 

2 

3 

4 

5 

6 

7 
10 
11 
12 
13 
14 
15 
16 
17 
20 
21 
22 
24 
25 

26-27 
30-31 
32 

33-35 
36-37 
40 
41 
42 

43-55 
56,57 
60 

61-6 3 
64 
65 
66 
67 

68-76 

77 

100-117 

120-137 

140-167 



.WAITR 

.WAIT 

.WRITE 

2 

.READ 

2 

.INIT 

.RLSE 

.TRAN 

. BLOCK 

.SPEC 

.STAT 

.LOOK 

.ALLOC 

.OPENx 

.CLOSE 

.RENAM 

.DELET 

.APPND 

.KEEP 

.RECRD 

2 
1 

Diagnostic Print 

2 

1 

General Utilities 

General Conversions 
1 

Command String Interpreter 
.EXIT 



.RUN 
.CVTDT 

2 
2 
1 



3-36 
3-35 
3-29 

3-28 

3-20 
3-21 
3-33 
3-31 
3-37 
3-38 
3-44 
3-39 
3-22 
3-22 
3-26 
3-41 
3-43 
3-46 
3-30 



3-50,-66 
3-67,-74 

3-76,77 
3-49 



3-47 
3-57 



(70, reserved for Multi-User Operation) 



(reserved for Communications Executive, COMTEX-11) 
(reserved for Real-Time Monitor, RSX-11) 
(reserved for user-implemented routines) 



^Reserved for Monitor internal communication, 
^Reserved for future Monitor expansion. 
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APPENDIX C 
SUBSIDIARY ROUTINES AND OVERLAYS 



with the exception of .READ/. WRITE and .WAIT, all Monitor code 

for performin g programmed requests is potentially non-resi d ent . Since 

non-resident modules are limited to a size of 256 words (the size of 
the swap buffer) and since many common functions are required, many 
of the programmed request modules must make use of subsidiary routines 
The table given below can be used in two ways: 

• when assessing the number of disk accesses required 
to satisfy a request, the table shows how many mod- 
ules (in addition to the primary module) may be 
loaded; 

• when making certain functions resident, one must 
not only make the primary module resident, but 
must also make resident each of the subsidiary 
modules which may be called. For example, if one 
wants all .OPENI processing routines (except for 
magtape) resident, he would put the following assembler 
directive in his program: 

.GLOBL OPN,FOP,LUK,CKX 
The following summary explains the codes used in the table. 

(blank) = subsidiary routine is never called 

X = subsidiary routine is called only when a 
file-structured device is referenced 

L = subsidiary routine is called only when a 
linked file is referenced 



= subsidiary routine is called only when a 



D = subsidiary routine is called only when 
DECtape is referenced 

M = subsidiary routine is called only if 
magtape is referenced 
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Name of Subsidiary Routine 














M 




Ui 






















Di 








O 




1 X 




TJ 


















s 


15 






O 




c u 




<u 


(U 




■P 












-H 


(U Qi 






H (1) 


Qi 


o o 




M 


1 rH 




•H +J 












+J 


S rH 






pa rH 




U rH 




a 


C -H 




m c 








m 0) 




CO 


•rl 




>1 


•H 


SJ 


m 




•H 


fa 




a) 








O rH 




-H 


Oi Pm 




u 


<u fa 




Q) 




h^l 


U 




+J e 








3 




X 


c 







■p 


-p +j 


•p m 






W 


0) 


X t7i 


0) 






<U 13 




w 


H -d 




•P Xi 


as -d 


•H C 


as 3 


CQ 


0) 


Q) d 


■d a 


CU 0) 


ft 


u 


M 


1 2 






■P <u 


0) 


o o 


U (U 


PQ 0) 


O 


^ to 


•p 


■P 


c as 


3 CO 


as 


CU 


CU 


(3 S 




C 0) 


(0 Ai 


W 0) 


(U u 


^^ 


a 


O S 


U QJ 


<U Q) 


CU 3 


0) +J 




■P C 


n3 


-d 


3 




(D rH 


(U c 


rH 


U fCJ 
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.ALLOC 
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. DELET 
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.RUN** 
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X 


X 
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M 


X 


X 


INR 


. INIT^ 
































RLS 


.RLSE** 

































Always resident. 

^Should never be made resident. 

^The .OPENO module requires a second section if a dataset other than CMO 
is being opened on the device assigned to CMO. 

"^The .RUN EMT calls the following routines: 



.INIT 

. OPENI 

.LDR 

.LD2 

.CLOSE 

.RLSE 



(once for each combination of filename and UIC) 
(three sections if LDA file; two if CIL file) 

(once for each .OPENI) 



'The .INIT module has two sections, but the second has no name. It is 
resident automatically if .INIT is resident. 
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APPENDIX D 
SUMMARY OF MONITOR COMMANDS 



Command 



Usage 



Commands to Allocate System Resources 

ASSiGN Assign a physical device to a logical device name 

Commands to Manipulate Core Images 

RUN Load and begin a program 

GET Load a program 

DUMP Write a specified core area onto a device as a core 



SAVE 

Commands to Start a Program 

BEGIN 

CO NTINUE 

RESTART 

Commands to Stop a Program 
STOP 

WAIT 
KILL 



image 

Write a program onto a device in loader format 



Start execution of a program 

Resume execution of a halted program 

Restart execution of a previously operating program 



Halt the current program, including any I/O in pro- 
gress 

Halt current program after finishing any I/O in progress 

Halt the current program, finish any I/O in progress, 
close all open files, and pass control back to the Mon- 
itor 



Commands to Exchange Information with the System 

DATE Fetch/Specify date 



TIME 



Fetch/Specify time 



(continued on next page) 



Optional characters are underlined. If any optional character appears, all must appear. 
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Command 



Usage 



Commands to Exchange Information with the System (Cont) 

LO GIN Enter User Identification Code 

MO DIFY Modify contents of memory location 

FI NISH Log off system 



Miscellaneous Commands 

ECHO 
PRINT 
E ND 
ODT 



Disable/enable keyboard echo to user program 
Disable/enable teleprinter output from user program 
End input from a device 
Begin operation of Octal Debugger (ODT) 



Optional characters are underlined. If any optional character appears, all must appear. 
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Global 
Mnemonic 


Function 


Macro Call 
(see notes) 


Assembly Language 
Expansion (see notes) 




Refer to Page 


.ALLOC 


Allocate a Contiguous File 


.ALLOC #LNKBLK,#FILBLK,#N 


MOV #N,-(SP) 
MOV #FILBLK,-(SP) 
MOV #LNKBLK,-(SP) 
EMT 15 




3-39 


.APPND 


Append to a Linkeei File 


.APPND #LNKBLK,#FIRST,#SECOND 


MOV #SECOND,-(SP) 
MOV #FIRST,-(SP) 
MOV #LNKBLK,-(SP) 
EMT 22 




3-43 


.BIN2D 


Convert Binary to Decimal ASCII 


.BIN2D #ADDR,WORD 


MOV WORD,-(SP) 
MOV #ADDR,-(SP) 
MOV #3,-(SP) 
EMT 42 




3-72 


.BIN20 
.BLOCK 


Convert Binary to Octal ASCII 


.BIN20 #ADDR,WOBD 


MOV WORD,-(SP) 
MOV #ADDR,-(SP) 
MOV #5,-(SP) 
EMT 42 




3-74 


Transfer a Block 


.BLOCK #LNKBLK, #BLKBLK 


MOV #BLKBLK,-(SP) 
MOV #LNKBLK,-(SP) 
EMT 11 
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.CLOSE 


Close a Dataset 


.CLOSE #LNKBLK 


MOV #LNKBLK,-(SP) 
EMT 17 




3-26 


.CORE 
.CSIl 


Obtain Core Size 


• CORE 


MOV #100,- (SP) 
EMT 41 




3-52 


CSI Interface - part 1 


.CSIl #CMDBUF 


MOV #CMDBUF,-(SP) 
EMT 56 




3-76 


.CSI2 


CSI Interface - part 2 


.CSI2 #CSIBLK 


MOV #CSIBLK,-(SP) 
EMT 57 
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Global 
Mnemonic 


Function 


Macro Call 
(see notes) 


Assembly Language 
Expansion (see notes) 


Refer to Page 


.CVTDT 


Convert Binary Date or Time to 
ASCII character string 


.CVTDT #CODE,#ADDR[, VALUE] 

VALUE is an optional argu- 
ment specified with Codes 
2 and 3 only. 


If Code = 3 

MOV VALUE+2,-(SP) 

If Code = 2 or 3 

MOV VALUE,- (SP) 

All codes 

MOV #ADDR,-(SP) 
MOV #CODE,-(SP) 
EMT 66 


3-57 


.DATE 


Obtain Date 


.DATE 


MOV #103,- (SP) 
EMT 41 


3-55 


.DELET 


Delete a File 


•DELET #LNKBLK,#FILBLK 


MOV #FILBLK,-(SP) 
MOV #LNKBLK,-(SP) 
EMT 21 


3-41 


.D2BIN 


Convert Decimal ASCII to Binary 


.D2BIN #ADDR 


MOV #ADDR,-(SP) 
MOV #2,-(SP) 
EMT 42 


3-71 


.EXIT 


Exit to Monitor 


.EXIT 


EMT 60 


3-49 


.GTCIL 


Get disk address of Core Image 
library 


.GTCIL 


MOV #111,- (SP) 
EMT 41 


3-63 


.GTUIC 


Get Current UIC 


. GTUIC 


MOV #105,- (SP) 
EMT 41 


3-59 


.GTPLA 


Get Program Low Address 


. GTPLA 


CLR -(SP) 
MOV #5,-(SP) 
EMT 41 


3-61 


. GTSTK 


Get the Stack Base Address 


. GTSTK 


CLR -(SP) 
MOV #4,-(SP) 
EMT 41 
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Global 
Mnemonic 


Function 


Macro Call 
(see notes) 


Assembly Language 
Expansion (see notes) 


Fefer to Page 


.INIT 
.KEEP 


Initialize a Dataset 


.INIT #LNKBLK 


MOV #LNKBLK,-(SP) 
EMT 6 




3-20 


Protect a File 


.KEEP #LNKBLK,#FILBLK 


MOV #FILBLK,-(SP) 
MOV #LNKBLK,-(SP) 
EMT 24 




3-46 


.LOOK 


Directory Search 


.LOOK #LNKBLK,#FILBLK[,1] 
,1 is an optional argument 


MOV #FILBLK,-(SP) 
MOV #LNKBLK,-(SP) 
EMT 14 

or when optional argu- 
ment is specified: 

MOV #FILBLK,-(SP) 
CLR -(SP) 
MOV #LNKBLK,-(SP) 
EMT 14 
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.MONF 


Obtain Full Monitor Size 


.MONF 


MOV #102,- (SP) 
EMT 41 




3-54 


.MONR 


Obtain Size of Resident 
Monitor 


.MONR 


MOV #101,- (SP) 
EMT 41 
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.OPEN 


Open a Dataset 


•OPEN #LNKBLK,#FILBLK 


MOV #FILBLK,-(SP) 
MOV #LNKBLK,-(SP) 
EMT 16 
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.OPENx 


Open a Dataset 


.OPENX #LNKBLK,R 


MOV #C0DE,-2(R) 
MOV R,-(SP) 
MOV #LNKBLK,-(SP) 
EMT 16 

C0DE=1 for .OPENU 

2 for .OPENO 

3 for .OPENE 

4 for .OPEN I 
13 for .OPENC 
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Global 
Mnemonic 


Function 


Macro Call 
(see notes) 


Assembly Language 
Expansion (see notes) 


Refer to Page 




.02BIN 


Convert Octal ASCII to Binary 


.02BIN #ADDR 


MOV #ADDR,-(SP) 
MOV #4,-(SP) 
EMT 42 
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.RADPK 


Radix-50 ASCII Pack 


.RADPK #ADDR 


MOV #ADDR,-(SP) 
CLR -(SP) 
EMT 42 
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.RADUP 


Radix-50 ASCII Unpack 


.RADUP #ADDR,WORD 


MOV WORD,-(SP) 
MOV #ADDR,-(SP) 
MOV #1,-(SP) 
EMT 42 
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• READ 


Read from Device 


.READ #LNKBLK,#BUFHDR 


MOV #BUFHDR,-(SP) 
MOV #LNKBLK,-(SP) 
EMT 4 
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.RECRD 


Read or Write a Specified 
Record in a File 


.RECRD #LNKBLK,#RECBLK 


MOV #RECBLK,-(SP) 
MOV #LNKBLK,-(SP) 
EMT 25 
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.RENAM 


Rename a File 


. RENAM #LNKBLK, #OLDN AM , #NEWN2m 


MOV #NEWNAM,-(SP) 
MOV #OLDNAM,-(SP) 
MOV #LNKBLK,-(SP) 
EMT 20 
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.RLSE 


Release a Dataset 


.RLSE #LNKBLK 


MOV #LNKBLK,-(SP) 
EMT 7 
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.RSTRT 


Set REstart address 


.RSTRT #ADDR 


MOV #ADDR,-(SP) 
MOV #2,-(SP) 
EMT 41 
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.RUN 


Load a program or Overlay 


.RUN #RUNBLK 


MOV #RUNBLK,-(SP) 
EMT 65 
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• SPEC 


Special Function 


.SPEC #LNKBLK,#SPCARG 


MOV #SPCARG,-(SP) 
MOV #LNKBLK,-(SP) 
EMT 12 
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Global 
Mnemonic 


Function 


Macro Call 
(see notes) 


Assembly Language 
Ex]Dansion (see notes) 


Refer to Page 


.STAT 


Obtain Device Status 


•STAT #LNKBLK 


MOV #LNKBLK,-(SP) 
EMT 13 
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.STPLA 


Set Program Low Address 


.STPLA #ADDR 


MOV #ADDR,-(SP) 
MOV #5,-(SP) 
EMT 41 


3-62 


.STFPU 


Initialize the Floating Point 
exception vector (11/45) 


.STFPU #PSW,#ADDR 


MOV #ADDR,-(SP) 
MOV #PSW,-(SP) 
MOV #3,-(SP) 
EMT 41 
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.STSTK 


Set the Stack Base Address 


.STSTK #ADDR 


MOV #ADDR,-(SP) 
MOV #4,-(SP) 
EMT 41 


3-65 


. SYSDV 


Obtain System Device Name 


.SYSDV 


MOV #106,- (SP) 
EMT 41 


3-60 


.TIME 


Obtain Time of Day 


.TIME 


MOV #104,- (SP) 
EMT 41 
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.TRAN 


Transfer Absolute Block 


.TRAN #LNKBLK,#TRNBLK 


MOV #TI^BLK,-(SP) 
MOV #LNKBLK,-(SP) 
EMT 10 
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.TRAP 


Set TRAP Vector 


.TRAP # STATUS ,# ADDR 


MOV #ADDR,-(SP) 
MOV #STATUS,-(SP) 
MOV #1,-(SP) 
EMT 41 


3-50 


.WAIT 


Wait for Completion 


.WAIT #LNKBLK 


MOV #LNKBLK,-(SP) 
EMr 1 


3-35 


.WAITR 


Wait for Completion; Return 
to ADDR 


. WAITR #LNKBLK,#ADDR 


MOV #ADDR,-(SP) 
MOV #LNKBLK,-(SP) 
EMT 


3-36 


.WRITE 


Write on a Device 


.WRITE #mKBLK,#BUFHDR 


MOV #BUFHDR,-(SP) 
MOV #LNKBLK,-(SP) 
EMT 2 
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NOTES ; 



I 



ADDR a memory address 

BLKBLK address of BLOCK Block 

BUFHDR address of Line Buffer Header 

CMDBUF address of Command String Buffer 

CSIBLK address of Command String Interpreter Control Block 

FILBLK address of Filename Block 

FIRST address of Filename Block of file which is to be appended to 

LNKBLK address of Link Block 

N number of 64-word segments requested 

NEWNAM address of Filename Block containing the file's new name 

OLDNAM address of Filename Block containing the file's old name 

PSW program status word for an exception routine 

R register from R0 through R5 containing address of Filename Block 

RECBLK address of RECORD Block 

SECOND address of Filename Block of file which is appended 

SP Stack Pointer (register R6) 

SPCARG code for Special Function or Address of Special Function Block as determined by Function called. 

TRNBLK address of TRAN Block 



APPENDIX F 
SUMMARY OF DOS ERROR MESSAGES 

Following is a complete summary of all error messages which 
can appear when using the DOS Monitor and system programs. 

F. 1 Keyboard Command Messages 

If a command cannot be executed satisfactorily, an appropriate 
mess age w i ll be pr i nted at the te l epr i nter an d the command will be 
ignored. The message will be one of the following. 

Message Meaning 

ILL CMD! Command requested does not exist 

INV CMD! Command cannot be accepted at this time (e.g., 
KILL with no program to kill) 

SYN ERR! Syntax of command is faulty 

ILL DEV! The device specified is illegal 

NO FILE! File specified does not exist or cannot be loaded 
by the RUN processor. 

ILL ADR! Address is illegal (not on word -bound or 
in core) 

NO CORE! Insufficient core capacity to execute command 
(SAVE) 

F. 2 Error Messages 

Error messages are printed on the teleprinter in the following 
format. 

CNNN XXXXXX 

where C is one of five letters identifying the type of message: 

I Information 

A Action required by the operator 

W Warning to the operator 

F Fatal error 

S System program error 

NNN is the message number; and XXXXXX gives appropriate additional 
information. Information , Warning , and System program messages 
are printed and the program continues. 

Action messages are printed and the program is suspended. The 
Monitor expects the operator to take some action such as "continue 
the program" (type CONTINUE) , or "kill the program" (type KILL) . 

Fatal error messages are printed if possible, and the program 
is suspended. The Monitor will not allow the operator to CONTINUE 
the program, but expects to see either a BEGIN, RESTART or KILL 
command. If a fatal error is a system disk failure and the error 
message cannot be printed, the central processor halts. This is the 
only time that a halt occurs in the Monitor. 
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F.2.1 Action Message 

Action messages are printed and the program is suspended. The 
Monitor expects the operator to take some action such as "continue the 
program" (type CONTINUE), or "kill the program" (type KILL). 

CODE/ISSUER ADDITIONAL INFORMATION/MEANING 

AJ2I01 User Call Address 

DOS Disk address error. 

Aj2fj32 Device (RAD50) 

DOS Device not ready. For example, 

the desired device/unit may be 
off-line or it may not be 
write-enabled. For DECtape or 
magtape, the proper unit may 
not have been selected. Make 
the device ready and type CO. 

Aj2(03 Link Block Address 

DOS The Link Block contains either 

an illegal device code or no 
device code at all. Use the 
MODIFY command to display the 
contents of Link Block+2, 
which is the dataset name 
(RAD 50) , and then use the AS- 
SIGN command to assign a de- 
vice and/or file; type CO when 
ready. 

AJ004 User Call Address 

DOS DECtape error. Try adjusting 

the tape; type CO to retry the 
operation. 

Aj0j35 Pause Number 

OTS A PAUSE was encountered in a 

FORTRAN program. Type CO to 
continue. 

AJ006 Correct Module Name 

LINK Paper tape loaded out of order 

on Pass 2 of Linker. Load cor- 
rect module and type CO to con- 
tinue. 

Aj2fj2f7 Call Address 

DOS The name of the output file 

being created on magtape is the 
same as that of an existing file. 
Type CO to write over the old 
file or mount another tape and 
then type CO. 

AJ2I1J2I 

DOS A parity error occurred when 

trying to open a file on magtape. 
Type CO to continue searching. 
If the file being sought has a 
parity error in its label, it 
cannot be found. 
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CODE/ISSUER ADDITIONAL INFORMATION /MEANING 

AJ011 = Date is Bad, 1 = Time is Bad 

DOS System date or time is not 

valid. Re-enter date or time 
via the console keyboard and 
type CO to continue. 

DOS Magtape error. After having 

made 15 entries on a WRITE or 
WRITE EOF, the operation is 
still unsuccessful. Type CO to 
ignore the error and proceed, or 
type KI to stop the program and 
start over with a good tape. 

AJ343 Disk Pack Block Number 

PIP This is the block that is bad; 

issued by the RPll pack initiali- 
zer to provide a list of bad 
blocks and to permit job termi- 
nation if too many are bad. Type 
CO if number of bad blocks thus 
far is tolerable. 

Aj05j0 j0 

BATCH Batch Stream Wait. 

Type CO to continue. 



A35i2f 

DOS Power has come up following a 

power failure. Any I/O in 
progress has been lost, but 
information in core and in the 
registers has been retained. 
If you wish to continue, type 
CO. Note, however, that if 
I/O was in progress, the 
driver (s) may have been left 
in a state which will not per- 
mit your program to be con- 
tinued. 
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F.2.2 Information Messages 

Information messages are printed and the program generally 
continues. 

CODE/ISSUER ADDITIONAL INFORMATION/MEANING 

1350 STOP Number 

OTS A STOP statement was executed 

in a FORTRAN program. 

1351 

FORTRN More errors of a specified type 
occurred than were allowed. 
The program is terminated. 

1352 Address of DEVTB Entry 

FORTRN The logical device specified is 
not available, (See FORTRAN 
device table, DEVTB, for a 
layout. ) 

1353 Error Class Number 

OTS No logging device. The command 

input device was in use when a 
run-time diagnostic message was 
to be issued. Because of a device 
conflict the normal message could 
not be issued. 

1354 j3 

PIP Illegal response to CONFIRM; 

when attempting to zero an 
RKll disk cartridge. The disk 
was not zeroed. Legal respon- 
ses are: 

H for high-density disks (RKJ03/J05) 
L for low-density disk (RKJ32). 
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F.2.3 Warning Messages 

Warning messages are printed and the program generally continues 
CODE/ISSUER ADDITIONAL INFORMATION/MEANING 



¥1002 
WJ043 

WljZfl 

W1J02 
Wlj03 
W1J04 
WljelS 
W1^6 
Wlj2l7 

W11J0 

Wl 1 1 
W112 
W113 
W114 
W3j0J0 



RSX 



RSX 



RSX 



RSX 



RSX 



RSX 



RSX 



RSX 



RSX 



RSX 



RSX 



LINK 



Device Name (RAD5J2I) 

Device time out. 

Block Number 

.TRAN to zero the disk. 

Number of Task Called 

Task called by number not present 
or call number illegal. Request 
ignored. 

Addr. in Call Sequence 

Delay units not correct in call 
start. Request ignored. 

Addr. in Call Sequence 

Delay time too large in call 
start. Request ignored. 

Addr. in Call Sequence 

No time slot available. Request 
ignored. 

Current Run-Time 

A level 1 task has exceeded its 

maximum run time. Task continued. 

Illegal or unrecognized console 
command. Command ignored. 

Report Number 

Illegal system report number in 
system command. Command 
ignored. 

Addr. in Call Sequence 

Attempted to start a background 
task while the background is busy. 
Request ignored. 

Addr. in Call Sequence 

Attempted to clock a background 
task. Request ignored. 

Symbolic task name not found. 
Request ignored. 

Command syntax error. Command 
ignored. 

Addr. in Call Sequence 

Illegal clock (call TRNON) time. 
Request ignored. 

0, Module Name 

Non-unique object module detected 
in first pass. Second and sub- 
sequent occurrences of the module 
are ignored. 
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CODE/ISSUER ADDITIONAL INFORMATION /MEANING 

W301 Addr. of Byte Error 

LINK Byte relocation error. Linker 

automatically continues. 

J3, Symbol and Module Names 
LINK Multiple definitions of global 

symbol. Second definition is 
ignored and linking continues. 

EDIT Buffer overflow. Overflow of 

one of the following Editor 
buffers: 

Command Input Buffer 

Save Buffer 

Page Buffer 



W3jei2 



W3j2i3 



W304 



W3j35 



W3J06 



W3J37 



W31J2( 



W311 



W312 



W313 



EDIT Macro overflow. The command 

string as stored in the Save 
Buffer was too long to execute, 
when requested to do so by an 
EM (Execute Macro) command. 

EDIT Recursive macro. The command 

string as stored in the Save 
Buffer, contains an EM command. 

EDIT Empty Save Buffer. An EM or U 

(Unsave) command was issued with 
nothing in the Save Buffer. 

EDIT Search failure. The n^h occur- 

rence of the search object was 
not found in the available test. 

EDIT Unsave failure. Insufficient 

room to copy the contents of 
the Save Buffer into the Page 
Buffer at dot. 

EDIT End-of-data detected. The end of 

the input file or the end of the 
input medium was reached during 
the last read of text into the 
Page Buffer, last page read was 
last in the file. 

EDIT Illegal line feed. A line feed 

character was encountered in the 
command string. 

EDIT Illegal negative argument. A 

negative argument was used with a 
command that does not accept 
negative arguments . 



F-6 



CODE/ISSUER 

W314 

EDIT 



W315 



EDIT - 



W316 



W317 



EDIT 



EDIT 



W3 2J2I 



EDIT 



W321 



EDIT 



W322 



W323 



W324 



W325 



W3 5j2f 



W3 52 



LINK 



RSX 



RSX 



RSX 



RSX 



RSX 



ADDITIONAL INFORMATION/MEANING 



Arguments not permitted. The 
command specified does not 
permit any argument with it. 

argument was not acceptable to 
the specified command. 

Illegal text string. 

Illegal command. The Editor was 
unable to execute the specified 
command. The command may be an 
illegal character, one that is 

» y^j- —w 'C<T-\-rm^l 1 ^<^«.w.-.«^J ^ Vv — -V- — ^ J- <-> 1^ 
ilUU CllX JCil^XJ. J.X COmiLLClJ.iU. CliClJ. d^ L.CJ. • 



Page Buffer almost full. The 
Page Buffer was within 128 
characters of being full. Write 
out part or all of the Page 
Buffer and then delete from the 
Buffer the part that was written. 

File closed. An attempt to Read 
from or Write to a primary file 
after an EF (End-of-File) command 
was issued. 



Undefined global symbols in load 
module. Linking continues. 

Illegal size of named .CSECT or 
illegal entry in named .CSECT or 
task's named .CSECT size too 
large. 

Too many entries in tasks named 
.CSECT. 

Illegal priority specification in 
real-time header. 

Number of Failures 

Powerfail interrupt occurred. 

Disk Error Code 

Disk error detected by RSX. 

Codes are: 

3 transmission error 

5 illegal error 

6 undefined file 

7 illegal file, i.e., linked 

8 block of file out of range 
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F.2.4 Fatal Messages 

Fatal error messages are printed p if possible, and the program 
is suspended. The Monitor will not allow the operator to continue the 
program, but eventually expects to see a BEGIN, RESTART or KILL com- 
mand. If a fatal error is a system disk failure and the error message 
cannot be printed, the central processor halts. This is the only time 
that a halt occurs in the Monitor. 

CODE/ISSUER ADDITIONAL INFORMATION/MEANING 

F000 Request Address 

DOS Dataset not INITed. Program 

must issue . INIT before any 
other requests to a dataset. 

Fj2Jj2(l Request Address 

DOS Stack overflow. Once loaded, a 

program requires additional space 
for its stack, buffers and control 
blocks. These are allocated as 
they are needed. Reduce the size 
of the program. If the error has 
been caused by a stack overflow, 
the stack pointer is reset by 
bytes before the message is printed. 
This allows the monitor to proceed 
(since it needs the stack) and leaves 
the top of the stack intact (though 
not pointed to by SP) . (See F.2.) 

Fj0j2f2 Request Address 

DOS Invalid EMT call. The EMT code 

issued by the program has not been 
assigned. 

F{3'P^3 Request Address 

DOS Invalid . TRAN function or . TRAN 

to an open file. 

FJ304 Error Code 

DOS Incorrect OPEN on industry com- 

patible magnetic tape. Caused 
by program error or improperly 
assigning devices via datasets. 
Defined error code values: 
J0 - another file currently opened 

on tape, 
1 - attempt to READ or WRITE to 

unopened file. 

FJ005 Request Address 

DOS .RLSE error. If a file has been 

OPENed, it must be CLOSEd before 
a .RLSE can be issued. 

F006 Request Address 

DOS Device full. No more space exists 

on the device being referenced by 
the request. For a file- 
structured device, use PIP to 
look at the number of free blocks 
and delete any files which are not 
needed. 

FJ2f07 Request Address 

DOS No buffer space available. In- 

sufficient space for completion 
of required operation. Reduce 
program size or close open files. 
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Fj?10 Request Address 

DOS Illegal .READ/. WRITE. Incor- 

rect mode for device or file 
not opened correctly. 

Fj2fll Request Address 

JDOS^ Illegal OPEN . OPEN code is not 

used or is unsuitable for device. 

Fj2fl2 Request Address 

File access violation. You are 
trying to OPEN a file that cannot 
be opened for the requested 
purpose. See Table 1 below for 
details. Assure that the name of 
the file requested was correct. 

Fj014 Request Address 

DOS Device '=^'*"ror "^r* ■'"^"in'^ ■'"'^ re^'^ 

bit map. The system cannot 
proceed if it cannot read the 
bit map. New files cannot be 
created on the device nor can 
old files be extended. Existing 
files may be copied to a backup 
medium for recovery. 

FJ015 Request Address 

DOS DECtape error. Nonexistent memory 

addressed or end-zone reached 
during transfer. 

Fj316 Block Number 

DOS DECtape search failure. Block 

requested cannot be found. 

FJ017 Device (RAD5JZ() 

DOS Parity error on file-structured 

device. 

F020 Irrelevant 

DOS Too many datasets using low-speed 

paper tape. A maximum of one 
each for input or output is al- 
lowed. Restart your job and use 
the ASSIGN command to reassign 
tiic excess datasets. 

F021 Irrelevant 

DOS Checksum error or device parity 

error while typing to load a pro- 
gram. Type KILL then try again. 
If that doesn't work, try re- 
linking the program. Try recreating 
the file. If the error persists, 
hardware may be faulty. Call 
field service. 

F022 Irrelevant 

DOS An attempt was made to load for 

execution a dataset which is not 
formated binary or which has no 
start address. Typically this 
means that the dataset being loaded 
is not a load module. 
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F|2f23 Program Size 

DOS Program too large for core 

available. Try to overlay the 
program or make it smaller. 

Fj2f24 Request Address 

DOS File access violation. You are 

trying to perform an operation 
that violates the monitor's 
user and file protection scheme. 
See Table 1 below for details. 
Resolve access problems with owner. 

Device (RAD50) 

Master directory full when at- 
tempting to add UIC. No more 
UIC's can be added. 

Disk Control Status Register 

Disk (RFll or RCll) transfer 
failure. Hardware error or 
persistent parity failure. 

Error Register 

Disk (RKll) transfer failure. 

Error Class, Number 

FORTRAN system error. An 
illegal call to the FORTRAN 
Error Processor was made. 

Addr. of Log Device 

No more room on FORTRAN logging 
deivce, or illegal end-of-file 
was encountered while a FORTRAN 
READ was in progress. 

F032 Status Register 

DOS Magtape hardware error. 

FJ033 Special Function Block Address 

DOS Invalid special function block. 

F^34 Call Address 

DOS The call code passed to a conver- 

sion request was invalid, e.g., 
5 means binary-to-octal, but 63 
is not defined. 

Block Number 

Illegal block number (RKll). 

Lowest Slot Used by Tasks 
No slot available. 

Lowest Slot used by Tasks 

Illegal slot specified. 

Low Address of Task Code 
RSX Attempted to overlay the execu- 

tive for another task. 



FJ2I25 


PIP 


FJ326 


DOS 


Fj027 


DOS 


FJ03J2I 


OTS 


Fjei31 


OTS 



Fj2f35 


DCS 


Fj03 6 


RSX 


F031 




F00 
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F|?41 


RSX 


Fi2f42 


DOS 


F^43 
FC'f44 


DOS 




LINK 


FJ2f45 


DOS 
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Load address of Binary Block 

Attempted to load outside 
limits defined in the command. 

Error Register 

Disk (RPll) transfer failure. 

Block Number 

Illegal block number (RPll) . 

^^ 

Error in command string passed by 
a Compiler via the .RUN request. 

Reguest Address 

The RUN EMT cannot find the 
requested entry in the speci- 
fied core image library. Add 
proper entry to CIL or use 
correct name. 

FJ2(5j0 Request Address 

BATCH Illegal I/O to batch stream. 

Either an illegal mode (e.g., 
unformatted binary when not 
in "OWN" mode) or a byte 
count less than 83/ on formatted 
read. 

FJ051 Request Address 

BATCH Too many successive read errors 

or EOF's while reading the 
batch stream. 

Fj2(52 PC 

BATCH Illegal Open to one of the 

Batch Datasets. OPENO and 
OPENI are the only legal 
OPEN'S and OPENO (OPENI) to 
an input (output) dataset 
is also illegal. 

FJ2f53 PC 

BATCH Illegal request to the BATCH 

stream flush EMT. Request 
code mus t be j? , 1 , or 2 . 

Fj?54 Address of DDB 

DOS An attempt was made to load a 

new program via the RUN request 
(EMT) before releasing all of 
the datasets INITed by the 
current program. Correct the 
program by releasing all INITed 
datasets before the RUN request 
is issued. 

Fj2f55 PC 

BATCH The time limit for the current 

job has expired. The current 
job has been aborted. 

Flj3fJ2f Address in Call Sequence 

RSX Insufficient arguments in call 

sequence or in console command. 
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F24j2f Irrelevant 

DOS An attempt was made to allocate 

a contiguous file, but not 
enough contiguous blocks are 
free. 

F274 Irrelevant 

DOS The stack base address has not 

properly set. Thus the stack 
could not be moved by the RUN 
EMT as requested.- This is 
probably a program error. The 
.STSTK request may be used to 
set the stack base prior to 
issuing the .RUN request. 

F275 

OTS Incorrect argument to link 

subroutine. 

F276 Request Address 

DOS The transfer address of the 

program or overlay to be loaded 
(by the RUN or GET commands or 
by the .RUN request) was not 
specified or is not legal. 
Specify a transfer address in 
your source program (END state- 
ment) or correct the /TR spec- 
ification in your linking pro- 
cedure. 

F277 Request Address 

DOS The program or overlay could not 

be loaded because it was outside 
the legal load area (on top of 
the Monitor or the main program 
or outside actual memory) . Re- 
link the program to conform to 
allowable boundries. Assure 
that the section being improperly 
loaded does not overlay the 

resident portion of your program. 
F3J2(j2f JZf 

FORTRN FORTRAN Compiler overlays cannot 
be executed. FORTRN. OVR may be 
nonexistent or improperly con- 
structed. 

F3n 

FORTRN No output file specified for 
the "/GO" options. 

F302 Action Word. 

DOS Illegal options requested in short 

form of RUNAEMT. 
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F34j2f PC at Time of lOT 

DOS The DOS error routine was called 

with an invalid error code. 
This might happen if the program 
branched into a data area 
since the integer 4 would be 
e xecuted as an JOT instruction 
(the error routine is called via 
an lOT) . 

F3 42 Contents of PC 

DOS Error trap. Probably caused by a 

reference to a byte boundary or 
to nonexistent memory or to a 
nonexistent device. Could also 
be caused as a consequence of 
the stack pointer being below 
400 or by executing JMP or 
JSR with register mode destina- 
tion. 

F3 44 Contents of PC 

DOS Reserved instruction trap. The 

instruction just executed is 
not a valid PDP-11 instruction. 
Perhaps you jumped to a point 
outside your program or perhaps 
you have stored information over 
an instruction. 

F346 Contents of PC 

DOS Trace trap. Bit 4 of the Proc- 

essor Status Register is on. 
Look for traps in the PDP-11 
Processor Handbook. 

F3 52 Contents of PC 

DOS Trap Instruction trap. A trap 

instruction was issued by your 
program and you did not previ- 
ously specify a trap address with 
the .TRAP request. 

F3 56 Contents of PC 

DOS Unexpected device interrupt. 

Either a new device has been 
added to your system without 
initializing the interrupt vec- 
tor or a hardware failure has 
occurred. 
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Table F-1 
Recovery from FJZI12 or Fj024 File Access Violations 

ACTION 



CONDITION 

Are you logged in? 

Is your UIC entered? 

Are you attempting to create a file 
which already exists? 

Does the Input file you are accessing 
exist? 

Are you attempting to delete a non- 
existent file? 

Are you attempting to delete a locked 
file? (The command to delete is cor- 
rect, and the file exists.) 

Are you attempting to access another 
user's file illegally? 



LOgin 

Enter it with PIP. 

Run PIP and DELETE 



Use PIP with /BR or /DI 
switch to check 

Use PIP with /BR or /DI 
switch to check 

Run PIP and UN lock 



Ask PIP to list the user's 
directory and see if an 
access error results 



F.2.5 System Program Messages 

System program messages are printed and the program continues, 
This class of error may be issued by a variety of system programs. 
If an ISSUER is specified, the error is unique to the indicated 
program. See the appropriate program manual for greater detail. 



CODE/ISSUER 



ADDITIONAL INFORMATION/MEANING 



SjZfjJl 

S200 
S201 
S2j2f2 

S2J33 

S2j2(4 
S2J05 
S2J26 



FORTRN 







FORTRAN Compiler has exhausted 
symbol table space during the 
assembly phase of compilation. 

Too many . CSECT directives. 

Conditionals nested too deeply, 



Error Status Byte. Dev: file, ext. 
EOD or device error on .WRITE 
or .READ; the disk may have 
filled up. 

Relative address of error call 

Illegal switch, or too many 
switches, or illegal switch 
value, or switch value not 
given, or switch in output field, 

Relative address of error call 

Too many or too few output files, 



Too many or too few input files. 

Relative address of error call 
No input files specified. 
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S2J07 Error Status Byte 

EOD or device error on .TRAN. 

5210 , dev:file.ext 

Unrecognized symbol table entry 
in indicated file. 

5211 , dev;file.ext 

ences a global name which cannot 
be found in the symbol table. 

5212 , dev:file.ext 

An RLD of the given file contains 
a location counter modification 
command which is not last. 

5213 , dev:file.ext 

Object module does not start with 
a GSD in the indicated file. 

5214 , dev:file.ext 

The first entry in the module is 
not the module name of the indi- 
cated file. 

5215 , devzfile.ext 

An RLD of the given file refer- 
ences a section name which cannot 
be found . 



S216 



S22J0 



S223 



S225 



S226 



The TRA specification references 
a nonexistent module name. 



S217 Relative address at error call. 

Insufficient core. 



An internal jump table index is 
out of range. 

No more room for CSI input buffer 
or Monitor's file manager routine, 
or Monitor's library search buf- 
fer. 



Program too large or top too low 
(program has been linked below 
zero in memory) . 

An open angle bracket, <, is pre- 
sent in a line other than the 
first. 
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S227 Error Code 

Illegal file combinations due to 
name conflicts. Defined error 
codes are: 

1 No Primary File (PRI) output, 

2 Secondary File (SEC) 

input = SEC output , 

3 SEC input = PRI output, 

4 PRI input = SEC output, 

5 PRI input = SEC input, 

6 PRI output = SEC output. 

S23jei Error Status Byte 

Error on. BLOCK I/O. 



S231 

S232 

S233 
S234 

S235 
S236 

S237 

S240 
S241 
S242 

5243 J0 

5244 j3 

5245 

5246 

5247 



Illegal command, file-structured 
device required. 

No more than one action switch 
permitted. 

Specified UIC not found in MFD. 

Null filename of "*" given 
where filename required. 

No files found in UFD . 

Operation applicable to DEC tape 
only. 

File not found during file re- 
covery operation. 

No space for file allocate. 

MFD is full. 

Meaningless command, no action 
taken. 

An open angle bracket, < , is not 
present in the first line. 

Already past requested position. 

Object module not found, could be 
out of order. 

Illegal library format. 

Listing requested, but unable to 
read output library from speci- 
fied output device. 
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S25J0 



S251 
S252 

S253 
S254 

S255 



S264 



S265 



Core library symbol table not 
specified first or consecutively 

No files found for "*" request. 

lowed . 
Linker error. 



It is illegal to zero the system 
resident disk. 



Match found in third of later 
binary block in a paper tape 
library. 

5256 

Illegal input device. 

5257 File Block Error Code, dev:file.ext 

Illegal file operation. For 
example, protect code does not 
allow transfer of file; UIC dif- 
ferent from Login UIC, thus 
making certain "wildcard" opera- 
tions illegal. The operation in 
question is not performed. 



S260 



S262 



Same device needed for input and 
output in fast copy operation 

Record size too big for buffer. 



S263 File Number 

File record sizes do not agree 
on verify, "/V" . 



Conflict in standard file name 
extension which determines 
mode of transfer. Use expli- 
cits to resolve. 

Operation attempted on device 
which is not legal for non- 
privileged user, for example, 
/PK PIP switch attempted by 
a user not logged in under [1,1] 
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APPENDIX G 
LISTING OF SYSMAC.SML (SYSTEM MACRO FILE) 



PT^-TT T^rrS KTFTFf^ Fffrl*7^«! \il?!fRk 



P S 1| A P ? 

R2i5!Ar2 

Rf5«^APi§ 

fi7st?!An7 
SPs^Are 

F C B •/ A n 7 
FSktA0t77776 

£WR.Ari77S7'? 
,FMrN« 

.MAfRO .TK'IT .IBLCK 
.^'CALl. .AHCIDF 
.AMrCF .LBI CK 
FMT <aCP> 
'.FNfM 

.WArfin ,Pt<5E J 81 CK 
.^CALL .A^'^DF 
.AMrCE ,1 BLCK 
EMT <AC7> 

, P N f: M 

.MAfRn .PLPSF .LBICK 
.^CALL .A^noF 
.AMTCF .1 81-CK 
FHT <aC!7> 

.TNTM 

.MACRO .READ ,iai.CK,',tPLPF 

.MCALL .AVnOF 

.AMCCF . I BIFF 

.AMCDF , I BLCK 

E^T <aC4> 

.FNry 
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BlCK/.UPtPF 



^'ACRn ,i*RTTF 
MCAtl .4M0DF 
AMncF .IBl.'FF 
AMCDP , I. RICK 
MT <AC5> 
FNTH 



^'ACRO .rpFNO ,L8l C^ , .FPLfK 

MCiLL .tODE,,CPFN 

rOTE ,FBLnK,<A02> 

rPFK .1 BLCK/.FRLCK 

FMTH 

MATPr .rPFKT ,1 BLCK^.PPLfK 

^Ctll ,ronE,.OPFN 

ratE .FBLCK,<Art4> 

nPFK j.bi ck/.frlck 

FNnf^ 



.CPFMJ .LBLCK/.FPLCK 

.ronE.,rPFN 
.FBi.CK,<Ari> 

,1 BLCK,'.FPLCK 



.nPFNr ,1 BLCK^.FPLTK 

,rODE,,f1PFN 

.FB!.CK#<Ari3> 

.1 blck/.fplck 



MATPp .rPFNF ,1 BLCXf.FPLCK 

^'CALL .ronE,,PPFN 

rOI'E .FBICK,<a03> 

rPFK .1 BI CK,,FRl.t^K 

FKJTM 



^ACPC 


f^CAU- 


rcrn 


nPFK 


FNry 


MArPf 


^'C*l.l.. 


rorE 


rpFK 


FNIP^ 



►^AfPn .CPFN 
HCALl. .AHnDF 
AMTCF .FBICK 
AMrcF ,1 Bl CK 
^'T <AC16> 
FNry 

MACRO .I'ATT 
^CALL .AMHDF 
AMPDF .I.BLCK 
MT <aC!> 
FWCM 

MATRP .UATTR 
MCALL .AMODF 
AHeCF .ADHH 
AMrOF .LBLCK 
MX <aC^> 
FNTH 

^'ACRD .PLCCK 
MCALI. .AMCOF 
A f' r C F . P B I. C K 
AMTDF .! BICK 

E M T < A c i 1 > 

,FNr;M 



.IBLCKp.FPirK 



.LBLCK 



BLCK,',Ar;CR 



BlCK^.BPUfK 
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yATRn 


. T R * K 


.! B!,C^- 


^Ct[\ 


, A M n D F 




4 M r f) F 


.TRICK 




*MrcF 


,1 PI CK 




M T < * C 1 f > 




F N P H 






V A r P n 


.?PFC 


,1 HICK 


^'cni. 


.AMTDF 




i. M r Q F 


,SARG 




AMrnF 


J HI C'< 





FN^^' 

^' A C R n 

•^CAU 

A M r n F 

^^ T < A C 1 3 > 

FNrv 



.STAT 
, AMCnF 

.IBI.Ck 



^CAl. I .AVCDF 

A ^^ I" n F , f.' 

Anrc^ .FBI c 

AMCCF .1 Rl CK 

yfj < A c 1 5 > 

^ACBn .HFI ET 

"CiLI. .A^'CHF 

AMrCF .FBICK 

AMrnF ,1 PI.CK 
»'T <aC?1> 
F M r y 

V A C R n , P F K A '^ 

wc*Ll .AMCDF 

AMCCF ,^FB 

AMrpF .CFP 

AMrrF ,1 PLCK 

F M r y 



^' A r R "^ 

^CAU 

AwrCF 
A M r c F 
A M r C F 

WT <aC??> 

FMry 



. 5PPKr 

.AMnCF 
.?FP 
.1FP 
.1 pi Ct< 



►'ACWn .1 OCK 
^^ C « L L . A w C F 
AMrCF ,FPt CK 
TIF VP..CP,CIR 
AMTCF ,1 P! CI* 
wj <Apl4> 

^ACKH .KF.FP 
^'CAL.I .AMTDF 
AMTCF .FBI CK 
ANCnF .1. PICK 

F^'T <aCP4> 

.FNTH 



.1 BLCK 



.1 PICK,.FPLCK,,N 



. I 81 CK,. FPL CK 



,1 8l..CK,.PFP,,KF» 



B! rK/,i«^e. ,?c-o 



. B I C K , , F p L r K , , n P 



fSP) 



LBI CK, .FPfK 
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.MACRH .FXTT 

.Fwrn 



.MATRO 

'. AwrnF 

FMJ <AC-dl> 

.FNry 



.TRAP 

.AMnOF 

.ADHR 

,ST1:S 

*A01f«C?!P5 



.STLSi.ADfR 



.AMTHF 

.Af^cnF 



.^STFPIJ 
,AM€DF 
.ADr!R 
.STUS 
#*P3f "CSP) 



STLSi.ADrR 



.MAfsn .BECRC 
.MCAL.l .AMCDF 
.AWrCF .RBI.CK 

.AMrrF J. BLTK 

F^T <a0?5> 
.FNTH 



BLCK^.RPLCK 



.MArRH 


.ruMp 


.^^CAU 


.AMCDF 


.AHrcF 


.1.01*^ 


.AM^CF 


.Hlf^N 


.AHrCF 


,rDF 


FMT <*C64> 


.FNiri*' 





.i.ow,,HTr,V',.crF 



.'■'Arpn .PSTRT .ADHR 

.•^CAL.1 .AMPnF 

.AMCDF .AOHR 

MflV *aC1?,-CSP) 

EMT <aC!4 3,> 

.FNTM 

.MArpn ,roPE 

r^rv *Ante«»f»(.'^P^ 

FHT <AC41> 

.FNinM 

.►'Arpn .h^oNP 

F^-T <aG41> 
,FN^^^ 

.MAPRP ,MOKF 
EMT <aC41> 

,^'ArRP .PATE 

Mpv *Aoie?,-(SPi 

F"T <aC41> 

■ F M r ►^ 



G-4 



F >•* T < A C 4 1 > 
.FNrS' 

M r V * A 1 f ; F , - f S p ^ 
E M q" _iAC 4-1 > 

.FKirM 

.^^Aren .patpk .ao^^r 

,^Cdl.l ,AMrCF 
.AMfCP .ADHR 
C! R * fS-P ) 

. F N !* ^ 

.^'ATKn .PAMiP .ADOC.wpr 

,^CALI .AMrOF 

.AMrrF .kRr 

.AMr^F .ADHR 

MTV * A 1 # * ( P P ^ 

FMJ <*C'52> 

.FNiry 

.^'ATRn ,n2'5|K .ADDR 

.AMrnF .ADHR 

.^'ACPr' ,»I^2^ ,AonR,,wRr 

.AWPHF ,URr 

,AMrr:'=^ .adhr 

F^'T <aC4 2> 

.FNrN 

.MATpn ,r?RlK .ADf^R 

,^^C4U, .AMHDF 

.ANTCF .ADHR 

VPV #ACd,-C?P? 

F^'T <.*C'i2> 
, F M r V 

.i^ATRn .PTv2r .AOf^Rf.wRr 

.•^CilJ .AvrDF 

.AMrcF ,uRr 

.AMrnP .AnnR 

HPV ^aC^i-CPP") 

FMj <aC'32> 
.FNjrv 
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►-'AfRn ,rsTi .fMnpF 
V T < A r K 6 > 

►■•Art^n ,r?T2 ,CSWtK 

MCAl I .AvrDF 

MAfR^ .rrrvT .aohr 

''^CAl.l .rVTDT 

rVTCT AaHP*/. AI^DP 
FMf>K 

»^Ar«i^ .TMrVT .ADHR 

^CAU- .rvTDT 

rvTDT ^ACi/.Ar^OR 



^'ArR 

TP 
Awrp 

TF 

Ayrn 
FNrc 

AWCC 

AMrc 

FwrM 



.rvTDT ,rnF,.AnDP,,VA|,i ,.VAL? 

.AMTDF 

.VAL2 

NP..VAL1 
.VAI 1 



.TDF 



^'ATfin ,r,TPLA 
CI R "fSP) 
MTV *An5»-(SP) 
F^^T <aC41> 

.FNTh' 



,^'ArRn .STPLA .ADf'R 
.MCAIJ. .AvnCF 
.AM'^nF .ADHR 
^ry *aOK ,« (9P1 

EMT <AC^1> 

,FNry 

.VATPn .GTCII 

M n V *i A n n. S - f s P 5 

EMT <aC^1> 
.FMTM 

, M A r R n . r T S T K 
CI f? -fSP) 

ynv *a04#-(5!P^ 

E»^T <aC41> 

.FNTK* 



.MATRn .?TPTK 
.WCAIJ ,Ah<nDF 



.AQHR 
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MTV *An4,-C5P') 

E *' T < A C ^ 1 > 

. F N r M 



, »• 4 r R n , P I : N: 

. *-' c H. I. . A y r n F 



PNJRL'< 



.MCAIJ .AMCDF 
.iMrcF .rOF 

,FNrf-' 



.roF 



J Tl-E MACPQ .AMfioF ACrEPT? HNF ARf:l„^'E^T AMD 

; A? A Elj^iCTIPK CF THE AD'^fiES*' UG HTDF DE 

J TkE APniiMFM RF^E^ATE:? the APPRrFPlATE 

I y r V T " " ( ^ f' ' , 

; ArnPE5.s mthes that are TRrLPLEsrvF fE.r/. 

J )tfSP)) PR LM^IKFLV fE.G, SP) I' ILL RESULT 

t 1^ A .EPRTP Tr ryn TKriuDUn tnf 

» VAIJ.E fJ thf ADf^RES? MO^E Cf^.^. ^fSPI 

» I? REFRFSEKTET AS 0i?KP6^), THE AfipL^'E^T ITSELF 

I AND T^'E TE^T "AHDRE^STNP ^rr^E ItLFGAL * "^ SYSTEM 

; N' A C P A i^' G '. 1^ E N T " , 



S P = 5! A n f 



, M A r RT , A M r* D E , A R G 

.^TvpF .?YM,.APG 

.TE LE,,SVM-Ar5 
ynv .ARG,-CSP5 

.'''EYIT 
,F\nc 



J .SVMaAP'nPESS M^rF ^ 



?R? TO R5 



.TE FQ, ,SYM«Ar7P-A0!7 

.fE LE, ,SYM^Ar7-An6 

wrv .ARr,,-(«sp5 

.*'EYIT 

.FK-rr 
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APPENDIX H 
PERIPHERAL DEVICES 



H.l OPERATING THE TELETYPE 



computers. It consists of a printer, keyboard, paper tape reader, 
and paper tape punch, all of which can be used either on-line under 
program control or off-line. The Teletype controls (Figure H-1) 
are described as they apply to the operation of the computer. 







OFF 
LINE Q LOCAL 

Figure H-1 ASR-33 Teletype Console 



H.1.1 Power Controls 



LINE 

OFF 
LOCAL 



The Teletype is energized and connected to the 
computer as an input/output device, under 
computer control. 

The Teletype is de-energized. 

The Teletype is energized for off-line opera- 
tion. 



H.l. 2 Printer 



The printer provides a typed copy of input and output at 10 
characters per second, maximum. 
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H.1.3 Keyboard 

The Teletype keyboard is similar to a typewriter keyboard. 
However, certain operational functions are shown on the upper part 
of some of the keytops. These functions are activated by holding 
down the CTRL key while depressing the desired key. For example, 
when using the Text Editor, CTRL/U causes the current line of text 
to be ignored. 

Although the left and right square brackets are not visible on 
the keyboard keytops , they are shown in Figure H-2 and are generated 
by typing SHIFT/K and SHIFT/M, respectively. The ALT MODE key is 
identified as ESC (ESCape) on some keyboards. 
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Figure H-2 ASR-33 Teletype Keyboard 

H.1.4. Paper Tape Reader 

The paper tape reader is used to read data punched on eight- 
channel perforated paper tape at a rate of 10 characters per sec- 
ond, maximum. The reader controls are shown in Figure H-1 and 
described below. 



START Activates the reader; reader sprocket wheel 
is engaged and operative. 

STOP Deactivates the reader; reader sprocket wheel 

is engaged but not operative. 

FREE Deactivates the reader; reader sprocket wheel 

is disengaged. 
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The following procedure describes how to properly position 
paper tape in the low-speed reader. 

a. Raise the tape retainer cover. 

b. Set reader control to FREE. 

c . Position the leader porti on of the ta pe ov er the read 

pens wiuXi "cnQ sprocKe'c^ vzeeG/ noxso over "cns sprocKSu 
(feed) wheel and with the arrow on the tape (printed 
or cut) pointing outward. 

d. Close the tape retainer cover. 

e. Make sure that the tape moves freely. 

f. Set reader control to START, and the tape will be read. 

H.1.5 Paper Tape Punch 

The paper tape punch is used to perforate eight-channel 
rolled oiled paper tape at a maximum rate of 10 characters per 
second. The punch controls are shown in Figure H-1 and described 
below, 

RELease Disengages the tape to allov; tape 

removal or loading. 

B.SP Backspaces the tape one space for each 

firm depression of the B.SP button. 

ON (LOCK ON) Activates the punch. 

OFF (UNLOCK) Deactivates the punch. 

Blank leader/trailer tape is generated by: 

1. Turning the TTY switch to LCCAL 

2. Turning the low speed punch on (depress ON button) 

3. Typing the HERE IS key 

4. Turning the low speed punch off (depress OFF button) 

5. Turning the TTY switch to LINE. 

H.2 OPERATING THE HIGH-SPEED PAPER TAPE READER AND PUNCH UNITS 

A high-speed paper tape reader and punch unit is pictured in 
Figure H-3 and descriptions of the reader and punch units follow. 
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H.2.1 Reader Unit 

The high-speed paper tape reader is used to read data from 
eight-channel fan-folded (non-oiled) perforated paper tape photo- 
electrically at a maximum rate of 300 characters per second. 
Primary power is applied to the reader when the computer POWER 
switch is turned on. The reader is under program control. How- 
ever, tape can be advanced past the photoelectric sensors without 
causing input by pressing the reader FEED button. 

H.2.2 Punch Unit 



The high-speed paper tape punch is used to record computer 
output on eight-channel fan-folded paper tape at a maximum rate of 
50 characters per second. All characters are punched under program 
control from the computer. Blank tape (feed holes only, no data) 
may be produced by pressing the FEED button. Primary power is 
available to the punch when the computer POWER switch is turned on. 




PAPER TAPE 



OFF LINE 



Figure H-3 High-Speed Paper Tape Reader/Punch 
Paper tape is loaded into the reader as explained below. 

1. Raise tape retainer cover. 

2. Put tape into right-hand bin with channel one of the 
tape toward the rear of the bin. 

3. Place several folds of blank tape through the reader 
and into the left-hand bin. 
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4. Place the tape over the reader head with feed holes 
engaged in the teeth of the sprocket wheel. 

5. Close the tape retainer cover. 

6. Depress the tape feed button until the leader tape is 
over the reader head. 



CAUTION 

Oiled paper tape should not be used in 
the high-speed reader or punch - oil 
collects dust and dirt which can cause 
reader or punch errors. 



H.3 THE LPll LINE PRINTER 

The LPll is a line printer with 80 column capacity , capable of 
printing more than 300 lines per minute at a full 80 columns, and 
more than 1100 lines per minute at 20 columns. The print rate is 
dependent upon the data and the number of columns to be printed. 

Characters are loaded into the printer memory via the Line 
Printer Buffer (LPB) serially. When the memory becomes full (20 
characters) the characters are automatically printed. This 
continues until the 80 columns have been printed or a carriage 
return, line feed, or form feed character is recognized. 

H.3.1 Printer Control Panel 

Figure H-4 illustrates the printer control panel on which are 
mounted three indicator lights and three toggle switches. 
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Figure H-4 Line Printer Control Panel 
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operation of the lights and switches is as follows: 



POWER light 



READY light 



ON LINE light 



TOP OF FORM switch 



PAPER STEP switch 



ON LINE/OFF LINE switch 



Glows red to indicate main power 
switch (located inside cabinet) is 
at ON position and power is available 
to the printer. 

Glows white, shortly after the POWER 
light goes on to indicate that in- 
ternal components have reached 
synchronous state and the printer 
is ready to operate. 

Glows white to indicate that ON LINE/ 
OFF LINE toggle switch is in ON LINE 
position. 

This switch is tipped toward the 
front of the cabinet to roll up the 
form to the top of the succeeding 
page . It is spring-returned to 
center position, and produces a 
single top-of-form operation each 
time it is actuated. The switch 
is effective only when the printer 
is off line. 

Operates similarly to TOP OF FORM 
but produces a single line step 
each time it is actuated. It is 
only effective with printer off line. 

This two-position toggle switch is 
spring-returned to center. When 
momentarily positioned at ON LINE 
it logically connects the printer 
to the computer and causes the ON 
LINE light to glow. Positioned 
momentarily at OFF. LINE, the logical 
connection to the computer is broken, 
the ON LINE light goes off , and the 
TOP OF FORM and PAPER STEP switches 
are enabled. 



H.3,2 Maintenance Panel 

The maintenance panel contains controls used for the line 
printer's initial set-up and maintenance. It is accessible only 
by opening the front cabinet door , located beneath the control panel . 

This panel contains three switches, and three indicators. 

1. Main AC power switch; 

2. PRINT INHIBIT switch - must be off (down) to enable printing; 
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3 . DRUM GATE indicator - if lit , drum gate not properly- 
locked; 

4. PAPER FAULT - if lit, check for no paper, or torn paper; 

5. PRINT INHIBIT indicator - if lit, turn PRINT INHIBIT 
switch off; 

6. MASTER CLEAR switch - spring-loaded to off (down); if 

toggle d to on — (up), re s et s printer log i c, turn s off 

READY and ONLINE indicators . 



H.3.3 Adjustment Controls 



Controls are provided as listed in Table H-1, 



Table H-1 Adjustment Controls 



Control 



Location 



Function 



Drum gate latch 



Tractor paper width 
adjustment 



Tractor horizontal 
tension adjustment 

COPIES CONTROL lever 



Paper vertical ad- 
justment control 



Top-of-form in- 
dicators 



Gearshift type knob near 
right-hand side of main- 
tenance panel . 

Setscrew at far right of 
tractor pressure plate 
behind drum gate. 

Next to left side of 
tractor paper width 
adjustment. 

Extreme upper right-hand 
corner of cabinet just 
above drum gate hinge. 



Knob at upper left of 
cabinet, directly above 
right-hand side of 
maintenance panel 



Red arrows visible when 
drum gate is swung open 
one on each side of 
paper directly below 
tractor pressure plates 



Unlocks drum gate 
which can then be 
swung open for access 
to components on back 

Adjusts right tractor 
for various paper 
widths; left tractor 
is factory adjusted. 

Adjusts horizontal 
tension of paper. 

Adjusts the distance 
between hammer bank 
and character drum 
for different numbers 
of printed copies. 
Settings are: 1-2, 
3-4 and 5-6. 

Adjusts vertical 
alignment of printing 
so that it prints on 
lined paper. Can be 
adjusted to plus or 
minus one line and 
may be adjusted while 
the printer is in 
operation . 

Aligns paper during 
loading. 
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H . 3 . 4 Loading Paper 

Follow the steps listed below to load paper into the printer. 

Step Procedure 

1. Open front door of cabinet to gain access to maintenance 
panel and turn main AC power switch on. Verify that con- 
trol panel POWER indicator lights. 

2. Lift control panel TOP OF FORM switch and release to move 
tractors to correct loading position. 

3 . Open the drum gate by moving the drum gate latch knob to the 
left and up. Swing drum gate open. 

4 . Adjust right-hand tractor paper width adjustment for proper 
paper width. This is accomplished by loosening the set 
screw on the 80-column model or by using the easy release 
mechanism on the 12^ column model. Make certain that the 
right-hand tractor is tightened in place after it is 
adjusted. 

5. Open spring-loaded pressure plates on both tractors. 

6 . Load paper so that a perforation is pointed to by the two 
red arrows (top-of-form indicators) . Paper should lie 
smoothly between tractors without wrinkling or tearing the 
feed holes. 

7. Close spring-loaded pressure plates on both tractors. 

8 . Adjust the COPIES CONTROL lever to the proper number for 
the number of copies to be made. For example, set to 1-2 
for single forms, set to 5-6 for six-part forms. 

9. Close drum gate and lock into position with drum gate 
latch. After approximately 10 seconds the control panel 
READY indicator should light. If it does not, check to see 
if any error is indicated. An error is indicated if one of 
the following lights is on: DRUM GATE, PAPER FAULT, or 
PRINT INHIBIT. 

10. Lift TOP OF FORM switch several times to ensure paper is 
feeding properly. 

11. Set system to on-line mode by lifting ON LINE/OFF LINE 
switch and verifying that ON LINE indicator lights. At 
this point, printed matter can be aligned with the paper 
lines by rotating the paper vertical adjustment knob. 

For further details on the LPll, refer to the LPll Line Printer 
Manual, DEC-11-ODLPA-A-D. 



H-8 



H.4 THE TUlO MAGTAPE DRIVE 

The TUlO is a magnetic tape drive which may be a 7- or 9-track 
unit and which will record data in densities of 200, 556 or 800 bits 
per inch. 

Figure H-5 shows the magnetic tape drive control panel and its 
schematic repre s entation. Table H-2 shows the meaning assigned to 
each indicator light and Table H-3 explains the function of each switch, 
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Figure H-5 Magnetic Tape Drive Control Panel 



H-9 



Table H-2 
Status Indicators 



Indicator 



Procedure 



PWR 

OFF-LINE 

LOAD 

SEL 

RDY 

WRT 

LD FT 



FWD 
END FT 



REV 

FILE PROT 



REW 



Indicates that power is being supplied to the drive unit. 
Indicates local operation by the control box. 
Indicates that the vacuum system has been enabled and 
the unit is prepared to accept on-line or off-line commands 
Indicates the tape transport has been selected by the con- 
troller (program) . 

Indicates that the drive is ready to accept requests for 
operation (provided the SEL light is also lit) . 
Indicates that the program has initiated a write opera- 
tion in the tape transport. 

Indicates that the tape mounted on this unit is at its 
Load point (BOT marker is being sensed) . REW command is 
disabled. 

Indicates that a forward command has been issued. 
Indicates that the tape mounted on this unit is at its 
end point (EOT marker is being sensed). FWD command is 
disabled. 

Indicates that a reverse command has been issued. 
Indicates that the tape may not be written on (No Write 
ring in tape reel). 
Indicates that a rewind command has been issued. 



Table H-3 
Switch Functions 



Switch 


Function 


PWR ON/OFF 
ONLINE/OFFLINE 

START/STOP 
LOAD/BR REL 

UNIT SELECT 
FWD/REW/REV 


Controls power to the drive. 

Transfers drive control to processor 
(ON LINE) or enables local control box 
control by operator (OFF LINE) . 

Initiates or terminates tape movement. 

LOAD position causes tape to be drawn 

into vacuum columns. 

Center position applies reel motion 

brakes. 

BR REL position releases reel motion 

brakes . 

Assigns a logical unit number (zero 
through seven) to this drive. 

Selects tape motion direction to be con- 
trolled by START/STOP switch. FWD posi- 
tion indicates transfer to take-up reel 
until EOT (end of tape) marker is sensed, 
REV position indicates transfer to file 
reel until BOT (beginning of tape) marker 
is sensed, REW position indicates transfer 
as in REV at a higher tape speed; when the 
tape stops at BOT, depressing the start 
switch again causes tape to unload. 



H-10 



H.4,1 Operating Procedur es 

H.4.1.1 Loading and Threading Tape - Use the following procedure to 
mount and thread the tape: 

Step Procedure 

1 Apply power to the transport by depressing PWR ON 

2 Ensure the LOAD/BR REL switch is in the center position 
(this applies the brakes) . 

3 Place a write enable ring in the groove on the file 
reel if data is to be written on the tape. 

Ensure there is no ring in the groove if data on the 
tape is not to be erased or written over. 

4 Mount the file reel onto the lower hub with the groove 
facing towards the back. Ensure that the reel is 
firmly seated against the flange of the hub. 

5 Install the take-up reel (top) as described in Step 4. 

6 Place LOAD/BR REL switch to the BR REL position. 

7 Unwind tape from the file reel and thread the tape 
over the tape guides and head assembly as shown in 
Figure H-6. 

8 Wind about five turns of tape onto the take-up reel. 

9 Set the LOAD/BR REL switch to the LOAD position to 
draw tape into the vacuum coliimns . 

10 Select FWD and press START to advance the tape to 
Load Point. When the BOT marker is sensed, tape 
motion stops, the FWD indicator goes out, and the 
LOAD PT indicator comes on. 

NOTE 

If tape motion continues for more than 10 seconds, 
press STOP, select REV (reverse) and press START. 
The tape should move to the BOT marker (Load Point) 
before stopping . 
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H.4.1.2 Unloading Tape - To unload the tape proceed as follows: 



Step 
1 

2 

3 

4 
5 



Procedure 

Press OFF-LINE switch if the transport has been 
operating in the on-line mode. 

Press STOP switch and select REW. 

Press START switch. The tape should rewind until 
the BOT marker is reached. 

Press the LOAD/BR REL switch to release the brakes. 

Gently hand wind the file reel in a counterclockwise 
direction until all of the tape is wound onto the 

CAUTION 

When handwinding the tape, do not jerk the reel. 
This can stretch or compress the tape which could 
cause irreparable damage. 

Remove the file reel from the hub assembly. 
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Figure H-6 Tape Transport Mechanism 
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H , 4 . 1 . 3 Restart After Power Failure - In the event of a power 
failure, the DECmagtape automatically shuts down and tape motion 
stops without damage to the tape. Return of power is indicated when 
the PWR indicator lights. To restart the transport proceed as 
follows: 

Step Procedure 

1 Press the LOAD/BR REL switch to release the brakes. 

2 Manually wind the reels to take up any slack in the 
tape. 

3 Set the LOAD/BR REL switch to the LOAD position to 
draw tape into the vacuum columns. 

4 Set ON-LINE/OFF-LINE switch to the desired position 
and continue operation. 

H.4.1,4 Restart After Fail-Safe - If the tape loop in either buffer 
column exceeds the limits shown in Figure H-6 , the vacuum system 
automatically shuts down and tape motion stops without damage to the 
tape. When this fail-safe condition occurs, the DECm.agtape does not 
respond to on-line or off-line commands. To restart the transport, 
perform Steps 1 through 4 in Paragraph H.4.1.3. 

H.4.1.5 - Tape Handling - Observe the following precautions when 
handling magnetic tape: 

a. Always handle a tape reel by the hub hole; squeezing the 
reel flanges can cause damage to the tape edges when winding 
or unwinding tape. 

b. Never touch the portion of tape between the BOT and EOT 
markers. Oils from fingers attract dust and dirt. Do not 
allow the end of the tape to drag on the floor. 

c. Never use a contaminated reel of tape. This spreads dirt to 
clean tape reels and can affect tape transport operation. 

d. Always store tape reels inside their containers. Keep 
empty containers closed so dust and dirt cannot get inside. 

e. Inspect tapes, reels, and containers for dust and dirt. 
Replace take-up reels that are old or damaged. 

f. Do not smoke near the transport or tape storage area. 
Tobacco smoke and ash are especially damaging to tape. 

g. Do not place the DECmagtape near a line printer or other 
device that produces paper dust. 

h. Clean the tape path frequently as described in Paragraph 
5.2.1. 
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H.5 THE TCll DECTAPE DRIVE 

Figure H-7 pictures the TCll DECtape drive unit. Table H-4 
shows the meaning of each indicator lamp and Table H-5 shows the 
function of each switch. 




Figure H-7 



TCll DECtape Drive 



To mount a DECtape on the TCll: 

1. Move the LOCAL/REMOTE/OFF switch to the OFF position. 

2. Mount a DECtape by centering it over the left band hub 
and pushing it firmly onto the spring loaded hub. 

3. Wind sufficient tape to wrap around the recording head 
guides and the empty DECtape reel which should be mounted 
on the right hand hub. 

4. Take up a few inches to tape on the right hand hub by hand, 

5. Move the LOCAL/REMOTE /OFF switch to LOCAL position, 

6. Depress the DECtape motion switch to the LOAD position 
until about 6 feet of tape are on the right hand hub. 
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7. Depress the ^\TiITE PROTECT switch or write enable as 
appropriate . 

8 . Assure that the unit number showing for this drive does 
not show on any other drive. 

9. Move the LOCAL/OFF/REMOTE switch to the remote position. 



To dismount a DECtape from the TCll: 

1. Move the LOCAL/OFF /REMOTE switch to the LOCAL position. 

2. Depress the tape motion switch in the rewind direction (■<-) 
until all the tape is on the left hand reel. 

3. Move LOCAL/OFF/REMOTE switch to OFF position. 

4. Pull the DECtape reel from the left hand hub. 
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APPENDIX I 
COMMAND STRING INTERPRETER 

1.1 SYSTEM PROGRAM/USER PROGRAM COMMAND STRINGS R "i :< - III. 

There is a single, general format for all system program 
command strings. All system programs use it, and any user program 
may also do so. These command strings are all processed by a 
Monitor routine, the Command String Interpreter (CSI) which is in 
Section 3.8.6. Any program expecting such a command first types 

# on the console to indicate the fact to the operator. The general 
format is 

ds-spec (7[ds-spec] ...]] . . . L<ds=spec J |^, [ds-spec]"] ... 

where "ds-spec" represents a dataset specifier (described in the 
next section), brackets indicate optional items, and elipsis (...) 
indicates that the preceding item may appear zero or more times. 
Items preceding the < (if any) describe output datasets; those 
which follow describe input datasets. 

1.2 CSI COMMAND FORMAT 

Whenever a system program requests input through the CSI, a 

# will be printed on the teleprinter (exception, ODT-llR prints an 

*) and the program will wait for the operator's reply. A CSI command 
may consist of one or more output dataset specifications, followed 
by <, followed by one or more input dataset specifications. 
Spaces , horizontal TABs , and nulls may appear anywhere in the 
string and are ignored. A command is terminated by typing the 
RETURN key, which causes both carriage return and line feed char- 
acters to be passed to the program. The line-feed character 
terminates the input. < need not occur. If it does, at least one 
input file specification must appear. Only one < per command is 
allowed. Commands can not be continued from line to line. 

A dataset specification must be delimited by a comma. If no 
items appear before the comma, it is interpreted as "this particular 
positional field will not be used". For example, suppose a program 
requires three (output) data specifications. Then the syntax: 
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Dataset Specification, ,Dataset Specification 

indicates that the second (output) dataset specified will not be 
generated . 

Each dataset specification is a field which describes a data- 
set. It generally contains information as to where to find the 
dataset, the file name and extension if the dataset is a file, the 
user identification code associated with the file, and one or more 
switches which request various actions to be performed. A dataset 
specification containing all of the above elements would appear as: 

dev:f ilnam.ext [uic]/sw. :v, : . . . :v /sw^tv^ : . . , -v , 

where: dev = The device specification consisting of two or three 
letters (and often an octal digit) terminated by a 
colon. The letters identify the device and the digit 
identifies the unit. Units must be given in octal. 
The colon delimits this field with one exception; 
only physical names as listed in Appendix A may be 
specified. For example, DTAl: is the correct speci- 
fication for DECtape, controller A, unit 1. The 
exception is SY: which is a generic name for the 
system residence device (e.g., on an RK system SY: 
is equivalent to DK:). If no digit appears, unit 
is assumed. If the device specification itself does 
not appear, the device is assumed to be the device 
last specified, on the current side of the <, if 
there is one; otherwise, the system disk (SY:) unit 
is assumed. 



Assumptions (defaults) do not carry across 
from output to input. 



the < , i.e. 



filnam = The file name specification consists of one or more 
letters or digits, or exactly one asterisk. The 
first six letters or digits specify the name. The 
first character must be a letter. All letters and 
digits in excess of six are ignored. 

The file name need not appear if the device is not 
file-structured or if the program can supply a name. 

.ext = The extension specification consists of a period, 

followed by one or more letters or digits, or followed 
by exactly one asterisk. The first three letters or 
digits specify the extension. All letters or digits 
in excess of three are ignored. 

The extension need not appear. 

The asterisk is used to specify "all". For example: 
*.EXT specifies all files with extension .EXT, 
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FIL.* specifies all files with name FIL, and 
*.* specifies all files and all extensions. 

[uic] = The User Identification Code (UIC) specification 

consists of a left square bracket, followed by one or 
more octal digits or exactly one asterisk, followed 
by a comma, followed by one or more octal digits or 
exactly one asterisk, followed by a right square 
^racketr^ The field to the left of the comma specifies 
the user's group and the field to the right of the 
comma specifies the user within the group. Both 
fields must be given in octal, and the largest valid 
octal number is 376 in both cases (0 is invalid) . 
For example, [12,136] is the correct specification 
for user number 136 of user group 12. 

NOTE 

visible on some keyboard keys; however, they 
may be typed using SHIFT/K and SHIFT/M, 
respectively. 

As in filnam and .ext, the asterisk specifies "all". 
For example: 

[*,136] specifies all users whose number is 136 
[12,*] specifies all members of user group 12 , and 
[*,*] specifies all users. 

The user identification code need not appear, in which 
case the default is the identification entered with 
the LOGIN command. 

/sw:v, :...:v = A switch specification consists of a slash (/) , 
^ followed by one or more letters or digits, and 

optionally followed by one or more value specifica- 
tions. A value specification is initially delimited 
by a colon. The value itself can be null, or consist 
of one or more letters, digits, periods, or dollar 
signs. Other characters are illegal. The digits 8 
and 9 are legal. 

For examples: /DATE: 12. 20 .69 might be a switch to 
enter December 20, 1969 in a date field. 

/DATE:12::69 might enter December, 1969 in a date 
field. 

Switches need not appear. If a switch does appear, 
it need not contain more than one letter or digit 
after the slash. For example: 

/S and /SWITCH2 are both legal. 

The first two characters after the slash uniquely 
identify the switch. For example: 

/S is treated as if it were /S null. 

/SWITCHl and /SWITCH2 are both treated as /SW. 

Table I-l summarizes the legal command syntax. 
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Table I-l 
.CSI Coinmand String Syntax Rules 



Item Which 






Item Immediately Following 








Last Appeared 
















t 


DEV: 


FILNAM .EXT UIC /SWITCH 


< 


Terminator 


* 


blank- 


* 


* 


* E * * 


* 


* 


* 


f 


* 


* 


* E * * 


* 


* 


* 


DEV: 


* 


E 


* E * * 


* 


* 


* 


FILNAM 


* 


E 


E * * * 


* 


* 


E^ 


.EXT 


* 


E 


E E * * 


* 


* 


E 


UIC 


* 


E 


E E E * 


* 


* 


E 


/SWITCH 


* 


E 


E E E * 


* 


* 


E 


< 


* 


* 


* E * * 


E 


E 


* 



Legend: E indicates error. * indicates legal. 
The next item encountered is the first item in the command string. 
^ .* is legal following FILNAM. 

For example, a device specification immediately followed by an exten- 
sion specification is an error, whereas a file name specification 
immediately followed by a comma is legal. Note that a /SWITCH 
specification is always legal even alone. In such a case, the system 
device SY: and a null filename are assumed. 

1.3 CSI COMMAND EXAMPLE 

An example of a complete command is: 

F1.E1,,DTA1:F2.E2/S:1<F3.E3[11,123] ,DTB:F4 .E4/ABC ,F5 .E5 

which is interpreted as explained below. 

a. The first positional output dataset is to be a file named 

Fl and will have extension El. It is to be put on disk unit 0, 
and catalogued under the ID of the user who entered the command 
No switches are associated with this dataset, 

b. The second positional output dataset will not be generated. 

c. The third positional output dataset is to be in a file named 
F2 and will have extension E2 . It is to be put on the 
DECtape which is mounted on unit 1 of controller A. This 
file is to be catalogued under the ID of the user who entered 
the command. The action indicated by switch S with value 1 is 
to be performed on this dataset. 
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d. The fourth and subsequent positional output dataset will not 
be generated. 

e. The first positional input dataset is a file named F3, and 
its extension is E3. It can be found on disk unit 0, cata- 
logued under the user number 123 of user group 11, No 
switches are associated with this dataset. 

f . The second positional input dataset^s^a file nam.edn^T and 
its extension is E4 . It can be found on the DECtape currently 
mounted on controller B, unit 0. Associate the ID of the user 
who entered the coitmiand with this dataset. Perform the action 
indicated by switch AB (not ABC) on this dataset. No values 
are associated with tEe switch. 

g. The third positional input dataset is a file named F5 and its 
extension is E5. It can be found on the DECtape currently 
mounted on controller B, unit 0. Associate the ID of the 
user who entered the command with this dataset. No switches 
are associated with this dataset. 

h. The fourth and subsequent input datasets are not required. 
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APPENDIX J 
SPECIAL I/O FUNCTIONS 

Certain I/O functions are sufficiently device-dependent that they 
are beyond the scope of the File System. The .SPEC request (see 
Section 3.6.12) is provided as a means of accommodating such functions. 

«» ^_- ■.'■:;>__!- ^i i J- ■_!;;■_ L-ji-v,"!; i ;:: '-j^ u. ^ s L. i c: 'wj^ u. -1. i ti s wil-w- cXJL ^ llllltfll^ ^ WliXCJIl XiiU.w:>t, iJS SJLX^nSj. 

a code in the range 0-255 or a pointer to a special function block. 
When a special function block is used, it must contain a code. 

In general, special function codes will have similar meanings 
from device to device. When a code has no meaning for a device, it 
is treated as a no-op. Currently, special functions are defined 



J.l MAGTAPE FUNCTIONS 



J. 1.1 Special Function Block 



The magtape driver requires a special function block to perform 
the special function requests. The following is the calling sequence 
for magtape special functions and the special function block format: 

SPEC #LNKBLK, #SFBLK 



SFBLK: 



BYTE Special function code 

BYTE Words to follow (must be 3 or larger) 

WORD Tape unit status (returned by driver) 

WORD User specified count or control information 

WORD Residue count (returned by driver) 



J. 1.2 Functions 



Code 

1 
2 
3 
4 
5 
6 
7 



Function 

Offline (rewind and unload) 

Write End-of-File 

Rewind 

Skip Record (s) 

Backspace Record (s) 

Set Density and Parity 

Obtain Status 
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J. 1.2.1 OFFLINE (Rewind and Unload) - function Code 1 

This request causes the magtape to be rewound to the beginning- 
of-tape (BOT) marker and SELECT REMOTE status to go off. If the 
last command to the driver for this device was a WRITE, three EOF's 
are written before rewinding. Thus, this function could cause data 
to be lost if it is issued before a CLOSE during READ /WRITE processing, 

J. 1.2. 2 WRITE END-OF-FILE - function Code 2 

This request writes an end-of-file (EOF) record on magtape. It 
may cause data to be lost as described under OFFLINE. 

J. 1.2. 3 REWIND - function Code 3 

The REWIND request performs the same function as OFFLINE except 
that the SELECT REMOTE status does not go off. 

J. 1.2. 4 SKIP RECORD (S) - function Code 4 

Skips forward over the requested number of records (SFBLK+4) 
until either the SKIP count is exhausted or until an EOF record is 
encountered, in which case the EOF is spaced over and counted, but 
the operation terminates and a residue count (SFBLK+6) is returned 
(if any) . 

J. 1.2. 5 BACKSPACE RECORD (S) - function Code 5 

This request skips backwards over the requested number of rec- 
ords until either the SKIP count is exhausted or an EOF or the BOT 
marker is encountered. If an EOF is encountered it is spaced over 
and counted , but the operation terminates and a residue count is 
returned (if any) . If the BOT marker is encountered, it is not 
skipped or counted. Instead, the operation is terminated and a 
residue count is returned. 

J. 1.2.6 SET DENSITY AND PARITY - function Code 6 

This request is ignored for 9-track tapes; it sets density and 
parity as follows for 7-track tapes: 
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DENSITY (SFBLK+5) PARITY (SFBLK+4) 



= 200 BPI = ODD 

1 = 556 BPI 1 = EVEN 

2 = 800 BPI 

3 = 800 BPI Diimp Mode 

The default density and parity are S00 BPI Dump Mode, ODD. In 
this mode, one byte from core is represented as two bytes on 7-track 
magtape. Changing from this default causes one byte from core to 
be represented by one byte on tape with a loss of the two high order 
bits (6-7) of the byte. 

J. 1 . 2 . 7 TAPE UNIT STATUS - function Code 7 

This request returns the current status of the tape unit in 
SFBLK+2 in the following form: 

Bits Content 

0-2 Last command was : 

= OFFLINE 

1 = READ 

2 = WRITE 

3 = WRITE EOF 

4 = REWIND 

5 = SKIP RECORD 

6 = BACKSPACE RECORD 

3-6 Unused. 

7 1 = TAPE AFTER EOF (BEFORE EOF IF LAST 

C0MJ4AND WAS BACKSPACE) 

8 1 = 
9 

10 

11 



12 

13 - 14 

= 200 BPI 

1 = 556 BPI 

2 = S00 BPI 

3 = 800 BPI DUMP MODE 

15 1 = LAST COMMAND CAUSED ERROR 

Tape unit status is returned in SFBLK+2 for all special functions 
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1 


= TAPE 


AT BOT MARKER 




1 


= TAPE 


AFTER 


EOT MARKER 


1 


= WRITE LOCK 


ON 




PARITY: 










= ODD 








1 = EVEN (DEFAULT = 


ODD) 




= 9 


TRACK 








1 = 7 


TRACK 






DENSITY: 









APPENDIX K 
PROGRAMS 



K.l The two following example program listings illustrate 

methods for utilizing DOS monitor services. Note tha t the 
assembly language expansions of the programmed requests 
are used. Users with less than 12K of core should code 
their programs as illustrated and assemble the resultant 
code with the 8K assembler. Users with 12K of core or more 
may replace the assembly language expansion code with ap- 
propriate programmed requests and assemble with MACRO-11. 
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Example Program #1 

IPROGRAM WHICH TYPES a Mf-SSAGE ON ThE TPLHTPF wHiLfc 

I ACCEPTING A MESSaGI^ Ff*nM THfe KgVBOARD. l*RiK,RAM REPEATS 



(?»S8C»0O!a 


Rii1«itf? 


v'l^C^^ITtl 


«l«Xl 


ei^ytiap? 


«2«%2 


i0Pti<S?^3 


^3«X3 


0I3»0^^4 


R4S514 


?05>0«5 


R5SJ55 


550013 5^6 


v5Pa%6 


ii^^0^s^7 


PC»5{7 


j'.^eiais 


C««15 


0059^313 


I.F»12 


000V>11 


HT»11 


^^i?!!?!? 


feRD»^»l»7 



0^»PI04 1040R6 £MT 6 

aa^iaiafi 012745' mqv <»unk2,w(Sp) ;injit iNKa 

i?ia0324 

E^C-ltl^la 11?I4»P«6 EMT 6 

^m^lA i^ia746' HOV ttFlLl»-CSP5 ?OP|N Fnw OUTPUT 

00^34^ 

0aifl020 )?l2746t MOV »LMK1 ,-(SP) 

M0Pi3l2 

iai^««24 IBi^XB EMT IS 

(8iai3026 ?iia74S» MOV i*fiu2,-CSp) lOPeN For Input 

0i3^0^5^ 01p746» HOV *iLNK2,«CSp) 

00PS384 

0.:;^^pi46 ie!40j6 EHT i6 

m^^*d 013746' MOV #HSG1,-(SP) fw»?lTF; fHF mFSS&GE 

054PI044 Pll!?746» MQV MLNl<l,-CSP) 

t^il^0i>i3 104^02 E-MT 2 

aE50l?!5>2 ^I273i)' MOV ttUlf3l*6,«P ISEI THE BUFFER POlNTgN 

^0t^l70 

i3»056 !^«5ia?e5 LOOPl; CL^ CR^5+ ICLEAH THE AnOPFSS ANO rNC«F:Mt;MT 

000060 02?0?7' CMP R0,»l.I91**»9!, Jfe'ND OF BuFFES? 

00P'3p»2 

i30i30e4 103774 BUO LOOPl ?N0» r,D BACi< A CONiTlNue CLKARlMr, 

a00C?6S inZTA^^ MOV <*UNKl,-fSp3 lYgSrCONTIMJE 

e>t»0!3l2 

001(5072 1940RI EMT 1 

i3'3*^l^/4 i^l?746' MOV *»t.lBlr*C5P) JNCI.RKAa L^JK^.tl^l 

0iatilP2 

«(^^H3 i^l?746l MQV #U^K2»-CSP3 

00P'3?4 

2l,'ai3ia4 1040?4 fe.M7 4 

ai1l!»ld6 {^l?74S» MOV «»LN<2,-CSP5 IWAIT 

«(lhi4?4 
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«3««ll2 


1«40'?H 




m^lXA 


132767 

000107 

550i2i043 




00»l22 


00JW16 




0910124 


012746' 

?f5p3l2 




01^0130 


104017 




ilkfAiA 4 %n 


f 3k 4 4^ ? il £ f 




^t ^>. rt m "wf tfr 


V' ■ ^ ," ftp L " ■• 

0530324 




1300136 


194(317 




0130140 


5512746' 

000312 




0(?M144 


l«4fe507 




0i9)»l4A 


012746' 

?!?ip324 




0i^0l58 


104^87 




004J154 


Pi0fe*l67 
17762^ 


fR«3l 



fcMT 1 

BITS #eR0SiUlBl+3 



J ANY feRROeS? 



&HE ERR3 Jye$i50 TO Thg Ef?f*ORJ»i 4QDRF..SS 

MOV #UNK1,-C5P) »N0, , Close L*^!*! 

cMl 17 

Mfty **! nsoVb f SpI I .f!i D'^E L^i-^ 

£MT 17 

MOV ttL,NKl,ipCSP) J.^lSe LNKl 

£MT 7 

MOV #lNK2i-C3P) ^,RLS6; L^f^^ 

EMT 7 

JMP BEGIN 



030160 104063 



EmT 60 



1 EXIT 0^ ANY gR«nR 



0'40162 ^?«C*l?i^ LIBI I 
00(<3165 000 

K00310 



,-<DRD fl0, 
.BYTE 0,0 



rMA5< BYTF COliNT 
•'FQkMaTTEO ASCII 



.^■^DRD IACTUaL byte CQU'^T 

,s,*80. JHESERVF. THE rtUF^E^* SPACE 



0i303l0 00i^l60' 
000312 000000 L^iKlI 
000314 016027 

000316 001 

000317 000 
0.30320 04242«) 



,^0R0 ERRl JERROR RETURN ADPRESS 

.wDRO jPOlNTgR 

,RAr)50 /DSl/ ?L0GICA|, mAME 

.BYTE 1,0 nJNlT 



RAO50 /KB/ 



?KEV3CIA«D 



000322 00^160' 

000324 00I7!0IJ)0 LM^gJ 

000326 016030 

000330 0Pil 

000331 0!^0 

000332 ?4?42ia 

000334 00^0^0 
030336 002 
000337 000 

0«0340 00«0(?0 PlUll 

030342 000000 

0^0344 «?000pSfl 



.^ORO ERR2 
,*0R0 
.RAL350 /nS2/ 
•dYTE 1,0 

•RAQ50 /KB/ 



TERROR RETURN ADDRESS 



;!<EY9aARn 



.*^ORD »G0 To FATAL E^ROR MESSAGE 
•BYTE 2,0 njPEN FOR OUTPUT 

,^0RO 0,0,0,0,0 ,'^jO '^AME, E)(T, 'lie, OR PRHTECT 
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ia(a«354 
0003S5 

«i50356 

000362 
05'03t>4 
000366 



?j P! kJ (? 

i(? (? '^ 



FTU?: 



.wohio J GO To f-ATAL. f-:f<Raw 
.Bvrg 4,0 ?nPFN For imput 

.wO-^D 0,5), PI, 5(5, 5^ ;nO NAMF, E)(T, UlCp 0*^ PROTECT 



0!-'9a370 

3ia«3/2 

00P5373 

0«*'13^-s 

00W401 
006)402 

0k)0404 
0yik54^5 
0^(3406 
0a»407 
000415) 

C?004l2 
00«J4l3 

00lc'4l4 
e»i?i?4l5 

0M*54l7 

35504251 

0i?td422 

030423 
tdc9 1^424 
00v?42b 

'a0vad26 
H';)0427 

0-^b$430 
i(J(?W43l 

0a«43g 
(a0i<3433 
0004^4 

0k9l^4<36 

0-30437 

0014440 
3(^1^441 

01^0442 
000443 
09)0444 



000 
05?0 
0002e'5 
015 
012 
011 
040 
123 

1?0 

101 

113 
040 
1?2 
117 
125 
l07 

110 

114 
131 

040 
l?4 
117 
^540 
131 
117 
1??5 
122 
040 
114 

HI 
l24 
124 

114 

1 0b 

040 

1«2 
117 
131 

040 
0lS 

i^l2 



'SSl! 



.W0*?0 210 



iMAii' rUTE COUNTS 
JFORKaTTED ascti 



•BYTE CS,UF,HT 



y ACTUAL. rtvTF COJNf 



.ASCII / SPEAK PQUGHUY TO VnU'^ LITTLE Hn¥ / 



•aVTE CR,LF,HT, 
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&5i^044S 


'^i\ 


0(^0446 


^m 


^0^447 


043 


0ia043a 


101 


i2afe345i 


MS 


^TidA^Z 


irt4 


0^^453 


V^4-E4 


^0M434 


11^2 


0304S*> 


l-?5 


0550456 


1^,1 


000457 


124 


000460 


040 


S300461 


110 


0^0462 


111 


00v?463 


U5 


0i^i?464 


^4*3 


0^tf4$5 


127 


0'?0466 


Ita 


i^M0467 


If'iS 


0t?G)47a 


115 


?!0l2547l 


04*.? 


■^«t»472 


Itv? 


0013473 


1^5 


i3--iJ(^474 


04>) 


■!?0(<?475 


1?3 


0V30476 


118 


^mA77 


las 


dW^b'^A 


1?5 


mm^x 


132 


aatasiaa 


IK5 


a^sfj^aj 


123 


00^5*84 


04^ 


0«^ 1^505 


015 


i(3^"^50S 


ai2 


ei'^HSid? 


^11 


m^^^x^ 


04 3 


0ia0sii 


ll0 


00^512 


135 


^30^5 1 3 


»4^ 


00^51 4 


117 


mm\5 


lie 


m^^i^ 


114 


0ia45l7 


131 


«J03i3S23 


m 4 rm 


■ui^'Q 


0-30521 


lPi4 


mm2.z 


117 


000S23 


IMS 


30^524 


133 


000525 


040 


3i^0526 


111 


^.50527 


124 


0t?a5<30 


(3451 


^),ik^53l 


124 


a^t353a 


M7 


01^0533 


fci4e» 


^i/i^^^A 


1(^1 



.ASCII • AND BEAT HTM wh^n hE SN£e2ES / 



.8YTE CR,Lf^#HT 



• ASCII / HE ONtV L^OES IT TO AkjmoY / 
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0130535 


116 




00053$ 


n.6 




i3«i«!537 


117 




0005^0 


I3l 




01^0541 


040 




00054a 


015 


,8YTE CR,UF 


i3!30543 


012 




C900S44 


011 




05905^5 


040 


.ASCII / BE 


ia?i0546 


1^2 




dm^^? 


l05 




00K55«! 


103 




000551 


101 




a<ai^552 


l?5 




0^0503 


123 




000554 


10S 




000555 


040 




0005S6 


110 




000557 


105 




0^50560 


040 




0305ei 


113 




000562 


ll6 




000563 


117 




00e5C>4 


127 




000565 


l?3 




000565 


040 




0005«57 


Itl 




000570 


124 




000571 


040 




000572 


l?4 




000573 


105 




000674 


15%1 




0910575 


133 




000576 


105 




000577 


l?3 




000600 


040 




000601 


015 


•BYTE CRiLF 


000602 


012 






00065?3 MS5END», 


, 




000604 


.EVEN 



BECAUSE HE KnQxS IT TEASrS / 



000001 .END 



8EGIN 


000P!0P!R 


CW 


8 000015 


f-RHR 


s ji'^^l^T 


ERRl 


00016(?!R 


E«R2 


000160R 


Ef^t^3 


0'10160R 


FIUI 


000340R 


FIL2 


00035fiR 


HT 


a ^iv-nHUl 


LP 


» 000012 


Ll91 


00016PR 


INKI 


0^03l2R 


UNK2 


00032<JR 


iCiOPl 


000066R 


HSGEMO 


« 0i;*?0603R 


MSGl 


000370R 


PC 


s%000007 


R0 


» % 5^ ifl ». 


Rl 


«5{000001 


82 


«%000002 


R3 


s?{0';^00-^3 


R4 

• 


»%000004 
a 0006a4R 


R5 


«5;000a05 


SP 


■ X0-/0i^06 
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Example Program #2 



0140004 
0000U 



0i?aP!42 
ia0iac!46 

a0<Sk)52 

0ka0«62 

5500064 

a£?0072 

0001^2 
0i.^0l^4 

0t5«ll0 
000112 



210000^ 



0000P!? 

0ia0iais 

000012 

000^1 I 
000004 
000002 
000107 
040000 
000107 

012746' 

000416 

104006 

012746' 

000430 

104006 

012746' 

000346 
104006 
0l?746' 

000372 
104006 
^050fi7 

00I?«210 

012767 

00C>tl44 

000344 

005067 

000316 

005067 

000314 

01274S' 

000246 

012746' 

00034S 

104002 

012746' 

000346 

104001 

01274S' 

000356 

012746' 

000372 

104004 

012746' 

000372 

1'>)40HI 

132767 

00^107 

001^241 



I PRQGRAH TO OUPLlCATir a PAPER TAPfe 

i USING TRAN-LEvei. PEnupSTS 

t 

fia5X0 

SPs^^ 

CR*15 
UF«12 

RO»04 
w««02 
G«107 
EQU"40000 
eROR«107 
BeGINI MOV ttlNKl,«(SP5 



MOV «*i.N<2,-CSP5 

EMT 6 

MOV *»UNK3»«CSP) 

EHT g 

MQV »tN<4,-f$P5 



iThanBlQck Function code for .^ead 

iTRANBtOCK FUNCTlONi CODE FOR .WRITE 

?ASCTI G 

iTranBLOCK FUNCTiaN/STATuS»EnO 

I.INIT UNKl 
i'.lNiT l.'^t<2 
UNIT LNK3 
I.INIT LNK4 



EMT 6 
STArTI Cur F^AGl 

MOV *100,,BLK1*4 



JZERO END FLAG 
flNlTlAUlZF BUFFER SIZE 



CUR BUFl+6 HNITIAUIZE INPUT BuFFER 

Cur BUFl+10 fINlTlAUiZE INPUT RUFFgR 

MQV #msg1,"(Sp3 f,mRlT^ UNK3.f^sGl 

HOV #UNiC3, -CSPD I 



E^T 2 

flQV tfU^J^Sf-CSP) 

EMT 1 

MQV «RUF1»-CSP) 

HOV Ul^KA,m(Sp) 

EMT 4 

MOV «UNt<4,*CSP5 

EMT I 

aiT9 *»ER0RiBUFl*3 



I, "AIT Ul^K3 
I.READ LM<4,8lJFl 

;,WAIT LN<4 
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0^0120 






0065144 

0i3ai52 



000170 



0^0176 

0g!02l2 

0ia02ii 

0^0222 
000224 

000230 

00f32>56 

00'^240 



55 1 5 59 

12276/ 

v^ f1 2 I ? 7 

0055234 

^01337 

U27fi7 inOpSl 

000004 

000250 

01?746» 

00040J> 

0l?746' 

;;?0i?t4l6 

104010 

012746" 

0013416 

104001 

^32767 

041710^0 

000222 

001406 

16«767 e^OMI 

00021S 

000210 



9Nfc eRR6 



BNfc STAf*T 



MOV i*8L!<l»-CSP) 

MOV ttUNKl,«(SP) 

&MT 10 

MOV «INKI,«'(SP5 

EMT 1 

BIT »E00,BLt<U6 



BEQ LOOPwi 

SUB BUKl + l£fl,BLKl'»'4 



^OV *»WFLAGl 



000242 
000244 
000246 
0002^0 

000251 

000232 
0002^4 



012767 

000001 
1^0(^040 

112767 LOOpv"! H0V8 «wr,bLKU6 

000002 

000176 

012746» 

0004c^2 

0127461 

??!0«430 

104013 

012746' 

0004321 

1040^1 

005767 

0000P!S 

001274 BnE STA«T 

?)00734 BR UOOP« 

EPRi: 

eR«2l 

£R«3I 

ERi^4l 

epRei 
ep?^7i 

FLAGll 
HSGl ; 



HDV ^BtKlfCSP) 

MOV ttUN'<2,-CSP) 

tMT 10 

MOV ifUNKg^-CSP) 

EMT 1 
TST FLASl 



tQ7 



MO 

yyEStS^T UP RgAD 



;,TRAM UNKl.aiKl 



f.l^AIT LNKl 



ITFST FUMCTION FnR gOQ 



jWfcSET WORDCOUMT Tr> FINAL 



I BuFFew»s SIZE 

;sfe.T eoo-fuag 



iSET Up i^RITE 



I. IRAN LNK2,BLKl 



^•WAIT LNK2 



lE^D OF DATA? 

lYES, START OVER 
|N0» GET MORE 



104060 

000000 

005*067 

000 

000 

00R067 

01S 



.WORD 
,t^Of*0 55, 
•BYTE 0,0 

.WORD 65, 
tQYTE CR,LF,HT 



lEXlT ON ANY ERROR 

»ls>EOD RECEIVEO ON READ 
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0a026S 


012 


00^296 


011 


ii&^2^7 


m 


8!ae!26a 


117 


000261 


101 


a^iaae? 


I 04 


laiajaa^j 


MA0 


ifS^ie w4 




^0id2«»5 


101 


000266 


120 


000267 


l05 


000270 


040 


0012271 


Ul 


a0«>272 


ll6 


000273 


124 


0558274 


117 


0ia«275 


040 


00^270 


122 


0^0277 


I0S 


0003(30 


101 


00i»S^l 


l04 


01? 453(92 


105 


00ia3<(53 


122 


0S50304 


019 


0i?03ia5 


012 


^00306 


011 


0i5ia3ia7 


120 


0013310 


12S 


0»i^3H 


123 


y9k)i^3i2 


U0 


0«a3i3 


040 


0003U 


40 


000315 


040 


00«)3i6 


040 


001^317 


107 


000320 


0S4 


0^0321 


040 


001^322 


103 


030323 


122 


000324 


040 


000325 


040 


000326 


040 


000327 


127 


000330 


i!0 


000331 


103 


0003^2 


116 


000333 


040 


0>;i0334 


122 


000335 


105 


000336 


101 


000337 


104 


0003^0 


131 


000341 


019 


000342 


012 




00S1344 


000344 


000242' 



, ASCII /UOA.D TAP£ INTO READER/ 



.BYTE C«,LF,Ht 

.ASCII /PUSH 5, C« WHEN SEaDV/ 



.BYTE C«,LF 

,EVEM 
,wO«0 ERR3 
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0?6»346 


S!00000 UNK3I 


• *«0R0 






0061350 


016027 


.RAO50 /DSW 






m^i^z 


001 


.BYTE W0 






00S5353 


000 








^(;)0334 


042420 


.RAD50 /KB/ 






006^356 


2>m^tfi^ BiiPii 


.*<iORO 4 






001(3360 


000 


•BYTE 0,0 






0^0361 


000 








00^3^2 


000004 
000370 
000370 


.WORD 4 
,«,+4 

.EVEN 






00037?! 


000242' 


,wORO tRR4 






0061372 


000000 LNK4I 


.ujORp 






000374 


01S027 


.RAO50 /OSl/ 






0iaia375 


001 


.BYTE 1,0 






000377 


000 








000403 


042420 


,RAD50 /KB/ 






000402 


000000 BLKn 


,!«)0R0 






001^404 


000440' 


,*^0S0 BUF2 






000406 


000144 


,^<QRD 100, 






000410 


000000 


• »iORO 






000412 


000000 


.WORD 






Z^^AlA 


000242' 


,*»iORD ERR3 






000416 


000000 IpNKU 


.WORD 






000420 


016031 


,RAO50 /DS3/ 






000422 


001 


.BYTE 1,0 






000423 


000 








000424 


063320 


,RAO50 /PR/ 






000426 


000242' 


,rtORD ERH2 






000430 


000000 IH^^l 


,*ORD 






000432 


016032 


,RAO50 /DS4/ 






000434 


001 


.BYTE 1.0 






00043S 


0P!0 








000436 


063200 
000604 BIIF2S 

P*0«00l 


.RAO50 /PP/ 
.»,+100, 

.ENO 






BEGIN 


0005^0plR 


BLKl 000402R 


8UFI 


00i^356R 


BUF2 


000440R 


CR » 000015 


ENDM 


000170R 


EOD f 


1 040000 


EROR ■ 00'>5107 


ERRl 


0VJ0242R 


ERR2 


000242R 


ERR3 000242R 


ERH4 


0;^0242R 


ERR5 


000242R 


ERR6 000242R 


t^^7 


0V10242R 


FLAGl 


000244R 


f, » 000107 


hT 


s (?! I 1 


If 


> 000012 


UNKl 0004lfiR 


UNK2 


000430H 


LNK3 


000346R 


I.NK4 000372R 


lOnPR 


0«0l32R 


LQOPw 


000204R 


MSGl 000246R 


PC 


• %Ci|^0!^07 


RO « 


1 000004 


R0 *%000000 


SP 


*%0<^0006 


START 


000030R 


^H B 000002 


* 


s 000604R 
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APPENDIX M 
CHARACTER CODES 



N.l CARD CODES 



CARD CODES 

(ANSI X3.26-1970) 



\Zone 
Digits^ 


12 


11 







12 



12 
11 


11 





12 
9 


11 
9 



9 


9 


12 


9 


12 
11 

9 




& 


— 





space 


{ 


1 


} 






1 


A 


J 


/ 


1 


a 


J 


~ 




SOH 


DCl 










2 


B 


K 


S 


2 


b 


k 


s 




STX 


DC2 




SYN 






3 


C 


L 


T 


3 


c 


1 


t 




ETX 


DC3 










4 


D 


M 


u 


4 


d 


m 


u 
















5 


E 


N 


V 


5 


e 


n 


V 




HT 




LF 








6 


F 





w 


6 


f 


o 


w 






BS 


ETB 








7 


G 


P 


X 


7 


g 


P 


X 




DEL 




ESC 


EOT 






8 


H 


Q 


Y 


8 


h 


q 


y 






CAN 










9 


I 


R 


z 


9 


i 


r 


z 






8-1 








grave 












EM 






NUL 


DLE 


8-2 


[ 


] 


\ 
























8-3 




$ 


» 


# 










VT 












8-4 


< 


* 


% 


@ 










FF 


FS 




DC4 






8-5 


( 


) 




5 










CR 


GS 


ENQ 


NAK 






8-6 


+ 


; 


> 


= 










SO 


RS 


ACK 








8-7 


1 


-- 


7 


" 










SI 


US 


BEL 


SUB 






• 
NOTES 

To determine the card punch for a particular character, locate the character 
in the table and read the corresponding zone punch and then digit punch. 
For example, the card punch for a % is 0-8-4. 

To obtain the character corresponding to a particular card punch, locate the 
junction of the zone punch and the digit punch. For example, the character 
corresponding to the card punch 12-1 1-9 is r. 

j Slots that do not contain characters represent card punches for which there 
i are no ASCII equivalents. 

1 
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M.2 ASCII CHARACTER SET 



ASai CHARACTER SET 
ASCII- 1968 (ANSI X3.4-1968) 

To obtain octal or decimal ASCII representation of a character, add the row value 
to the coliomn value. 



\Coluinn 


































\yalue 
Row\ 


000 


008 


016 


024 


032 


040 


048 


056 


064 


072 


080 


088 


096 


104 


112 


120 


Value N. 


000 


010 


020 


030 


040 


050 


060 


070 


100 


110 


120 


130 


140 


150 


160 


170 





NUL 


BS 


DLE 


CAN 


space 


( 





8 


@ 


H 


P 


X 


grave 


h 


P 


X 


1 


SOH 


HT 


DCl 


EM 


I 


) 


1 


9 


A 


I 


Q 


Y 


a 


i 


q 


y 


2 


STX 


LF 


DC2 


SUB 


»» 


* 


2 




B 


J 


R 


Z 


b 


J 


r 


z 


3 


ETX 


VT - 


DCS 


ESC 


# 


+ 


3 


J 


C 


K 


S 


[ 


c 


k 


s 


- 


4 


EOT 


FF 


DC4 


FS 


$ 


, 


4 


< 


D 


L 


T 


\ 


d 


1 


t 


1 


5 


ENQ 


CR 


NAK 


GS 


% 


- 


5 


= 


E 


M 


U 


1 


e 


m 


u 


J 


6 


ACK 


SO 


SYN 


RS 


& 




6 


> 


F 


N 


V 


(t) 


f 


n 


V 


(ESC) 


7 


BEL 


SI 


ETB 


US 


apos 


/ 


7 


? 


G 





w 


(^) 


g 


o 


w 


DEL 



} decimal ASCII 
} octal ASCII 



Differences in the ASCII Standard 

Octal (ASCII 1963) ASCII 1968 

136 t ^ (circumflex) 

137 <- _ (underline) 
176 ESC 



DLE DATA LINK ESCAPE (tP) 

DCl DEVICE CONTROL 1 (tQ) 

DC2 DEVICE CONTROL 2 (tR) 

DC3 DEVICE CONTROL 3 ( t S) 

DC4 DEVICE CONTROL 4 (STOP) (tT) 

NAK NEGATIVE ACKNOWLEDGE (tU) 

SYN SYNCHRONOUS IDLE (tV) 

ETB END OF TRANSMISSION BLOCK (tW) 

CAN CANCEL (tX) 

EM END OF MEDIUM (tY) 

SUB SUBSTITUTE (tZ) 

ESC ESCAPE (t[) 

FS FILE SEPARATOR (t\) 

GS GROUP SEPARATOR ( t ] ) 

RS RECORD SEPARATOR (tt) 

US UNIT SEPARATOR (t<-) 

DEL DELETE (RUBOUT) 

The tx character is produced by depressing the CTRL key and at the same time depressing the x character 
key. 



NUL NULL 

SOH START OF HEADING ( t A) 

STX START OF TEXT (tB) 

ETX END OF TEXT (tC) 

EOT END OF TRANSMISSION (ID) 

ENQ ENQUIRY (tE) 

ACK ACKNOWLEDGE (tF) 

BEL BELL (tG) 

BS BACKSPACE (tH) 

HT HORIZ. TABULATION (tl) 

LF LINE FEED (t J) 

VT VERT. TABULATION (tK) 

FF FORM FEED (tL) 

CR CARRIAGE RETURN (tM) 

50 SHIFT OUT (tN) 

51 SHIFT IN (tO) 
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NOTES 



1 . Teleprinters manufactured by Teletype Corporation, Skokie, Illinois, have used codes 1 75 (ALT) and 
176 for ESC. Programs may forgo the use of ]- (175) and ~ (176) in order to use these codes as ESC on 
older teleprinters. 

2 . ASCII is a seven bit character code with an optional odd parity bit (200) added for many devices. Pro- 
grams normally use just seven bits internally; the 200 bit is either stripped or added so the program will 
operate with either parity or non-parity generating devices. 

ISO Recommendation R646 and CCITT Recommendation V.3 (International Alphabet No. 5) is identi- 
cal to ASCII except that number sign (043) is represented as £ instead of # and certain characters are 
reserved for national use. 
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APPENDIX N 
GLOSSARY AND ABBREVIATIONS 



A/D Analog-to-digital 

ADC Add Carry 

ADRS Address 

ASCII American Standard Code for Information Interchange 

ASL Arithmetic Shift Left 

ASR Arithmetic Shift Right 

Automatic Send/Receive 

B Byte 

BAR Bus Address Register 

BBSY Bus Busy 

BCC Branch if carry clear 

BCS Branch if carry set 

BEQ Branch if equal 

BG Bus Grant 

BGE Branch if greater or equal 

BGT Branch if greater than 

BHI Branch if higher 

BHIS Branch if higher or same 

BIC Bit Clear 

BIS Bit Set 

BIT Bit Test 

Bit Map A table describing the availability of space. Each bit in the 

table indicates the state (occupied or free) of one segment of 
storage, for example a block on a bulk storage device. 



BLE Branch 

BLOS Branch 

BLT Branch 

BMI Branch 

BNE Branch 

BPL Branch 

BR Branch 



f less or equal 
f lower or same 
f less than 
f minus 
f not equal 
f plus 



N-1 



BRD 
BRX 
BSP 
BSR 

BSY 

Buffer 

Buffer Use Table 

BVC 

BVS 

CBR 

CIL 

CILUS 

CLC 

CLK 

CLN 

CLR 

CLV 

CLZ 

CMP 

CNPR 

CNTL 

COM 

COND 

CONS 

CONT 

Contiguous File 

Core Bif Map 

Core Image 

CP 

CSI 

CSR 



Bus Register Data 

Bus Request 

Back Space 

Bus Shift Register 
Back Space Record 

Busy 

A storage area . 

A bit map in the permanently resident monitor, which describes 
the availability of buffers in the free core area. 

Branch if overflow clear 

Branch if overflow set 

Console Bus Request 

Core Image Library 

Core Image Library Update & Save Program 

Clear Carry 

Clock 

Clear Negative 

Clear 

Clear Overflow 

Clear Zero 

Compare 

Console Nonprocessor Request 

Control 

Complement 

Condition 

Console 

Contents 
Continue 

A file consisting of physically contiguous blocks on a bulk 
storage device. 

That portion of a Permanent Bit Map which happens to be in 
core. Not to be confused with the Buffer Use Table, 

A copy of what a program or other data would look like if 
it were in core. 

Central Processor 

Command String Interpreter 

Control and Status Register 
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D 

D/A 
DAR 
DAT 

Dataset 

DATI 

DAT IP 

DATO 

DATOB 

DBR 

DCDR 

DDB 

DE 
DEC 

Default Device 

DEL 

DEP 

DEPF 

Device Driver 



DIV 

DMA 

DSEL 

DST 

DSX 



Data 

Digital-to-analog 

Device Address Register 

Device Assignment Table. Contains the specifications from 
ASSIGN commands, 

A lopical collection of data which is treated as an entity by 
a program. For a more detailed description see Section 1 .6,1 , 

Data In 

Data In, Pause 

Data Out 

Data Out, Byte 

Data Buffer Register 

Decoder 

Dataset Data Block. Contains Monitor control information 
for a dataset . 

Destination effective address 

Decrement 

Digital Equipment Corporation 

The device specified in the Link Block of a dataset, and which 
is used for I/O operations on that dataset if there is no other 
device assigned in a DAT entry for the dataset. 

Delay 

Deposit 

Deposit Flag 

The minimal routine which controls physical hardware 
activities on a peripheral device. The device driver is the 
interface between a device and the common, device- 
Independent I/O code in the monitor. 

Divide 

Direct Memor*' Access 

Device Select 

Destination 

Display, X-deflectlon Register 



EMT 

ENB 

EOD 

EOF 

EOM 

ERR 



Emulator Trap 

Enable 

End-of-data 

End-of-file 

End-of-medium 

Error 
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EX 

EXAM 

EXAMF 

EXEC 

EXR 



Fatal Error 
FBM 

FCTN 
FIB 

File 

FILO 
FLG 



External 
Examine 
Examine Flag 
Execute 
External Reset 

Flag (part of signal name) 

An error from which a user's program cannot recover. 

File Bit Map - A device-resident bit map with bits flagged for 
the blocks used for a single file. Used on DECtape to aid in 
the deletion process. 

Function 

File Information Block. Contains (in core) information from 
the UFD and other sources when a file is open. 

A physical collection of data which resides on a directory- 
structured device and is referenced through its name. 

First in, last out 

Flag 



GEN 

INC 

INCF 

IND 

INDIVR 

INH 

INIT 

INST 

Interleave Factor 



INTR 
INTRF 
I/O 
lOT 



Generator 

Increment 
Increase 

Increment Flag 

Indicator 

Integer Divide Routine 

Inhibit 

Initialize 

Instruction 

The optimal minimum distance, measured in number of 
physical device blocks, between logically adjacent blocks 
of a linked file. Presently it is four on all PDP-11 bulk 
storage devices. For example, if physical block N is 
assigned to block 1 of a linked file, then physical block 
N+4 would be the closest device block that could be 
assigned to block 2 of that file. 

Interrupt 

Interrupt Flag 

Input/Output 

Input/Output Trap 
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lOX Input/Output Executive Routine 

IR Instruction Register 

IRD Instruction Register Decoder 

ISR Instruction Shift Register 

JMP Jump 

JSR Jump to subroutine 

Julian Date A 5-digit (decimal) numerical representation of the date, in 

which the two high-order digits give the year (1900=00, 
1 999=99) and the three low-order digits give the day 
within the year (January 1 = 001 , December 31 = 365 
(366 for leap year)). For example, January 28, 1971 
is represented as 71028, 

KSB Keyboard Swap Buffer. The non-resident routines which 

process keyboard commands are brought into the keyboard 
swap buffer, 

LIFO Last In, First Out 

Linked File A file consisting of a set of blocks within which an ordering 

is specified through the use of a link word imbedded within 
each block. 

Linker A systems program which creates a load module to be loaded 

into core memory. The linker relocates and links internal and 
external symbols to provide communication between independ- 
ently assembled programs. 

LKS Line time clock status register 

Load Module The output of the linker. A program in absolute binary 

form ready for loading and executing on a PDP-1 1 , 

LOC Location 

LP Line Printer 

LSB Least Significant Bit 

LSBY Least Significant Byte 
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MA Memory Address 

MAR Memory Address Register 

MBR Memory Buffer Register 

MEM Memory 

MFD Master File Directory. Contains the names and locations of 

all UFDs on a file-structured device. 

ML Memory Location 

MOV Move 
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MRT 

MSB 
MSB 

MSBY 
MSD 
MSEL 
MSYN 



Monitor Residency Table. Contains the address (on disk 
or in core) of all non-resident Monitor modules. 

Most Significant Bit 

Monitor Swap Buffer. The non-resident routines which process 
requests to the Monitor are brought into the main swap buffer. 

Most Significant Byte 

Most Significant Digit 

Memory Select 

Master Sync 



ND 

NEG 

NOR 

NPG 

NPR 

NPRF 

NS 



Negative Driver 
Negate 
Normalize 
Nonprocessor Grant 
Nonprocessor Request 
Nonprocessor Request Flag 
Negative Switch 



Object Module 

ODT 

OP 

Operator 

OPR 

PA 
PAL 
Parity Bit 

PB 
PBM 



PC 
PD 
PDP 
PERIF 



The relocatable binary output of an assembler or compiler. 

Octal Debugging Technique 

Operate 
Operation 

A user communicating directly with the Monitor through the 
keyboard . 

Operator 
Operand 

Parity Available 

Program Assembly Language 

A binary digit appended to an array of bits to make the 
sum of all the bit values always odd or always even. 

Parity Bit 

Permanent Bit Map - A bit map which describes the avail- 
ability of space on a DECtape or disk. It resides on the 
device it describes, and can be read into core in segments, 
called Core Bit Maps, for reference or updating. 

Program Counter 

Positive Driver 

Programmed Data Processor 

Peripheral 
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PGM 

PP 

PPB 

PPS 

PR 

PRB 

PROC 

PRS 

PS 

PTR 
PTS 
PUN 



Program 

Paper Tape Punch 

Paper Tape Punch Buffer Register 

Paper Tape Punch Status Register 

Paper Tape Reader 

PoDsr Tqds Reader Buffer Reaister 

Processor 

Paper Tape Reader Status Register 

Processor Status 
Positive Switch 

Priority Transfer 

Paper Tape Software System 

Punch 



Radix -50 packed ASCII 

RD 

RDR 

REG 

REL 

RES 

ROL 

ROM 

ROR 

IVS 

RTI 

RTS 

IVW 

RA^SR 

S 

SACK 

SAL 

SAM 

SBC 

SC 

SE 



A format in which 3 ASCII characters (from a subset of all 
ASCII characters) are packed into a single 16-bit word. 

Read 

Reader 

Register 

Release 

Reset 

Rotate Left 

Read-only Memory 

Rotate Right 

Rotate/Shift 

Return from Interrupt 

Return from Subroutine 

Read/Write 

Read/Write Shift Register 

Single 

Selection Acknowledge 

A friend of SAM. 

Swap Area Manager 

Subtract Carry 

Single Cycle 

Source Effective Address 
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SEC 

SEL 

SEN 

SEV 

SEX 

SEZ 

SI 

SP 

SR 

SRC 

SSYN 

ST 

STPM 

STR 

SUB 

SVC 

SVT 

SWAB 

Swapping 



Set Carry 

Select 

Set Negative 

Set Overflow 

Sign Extend 

Set Zero 

Single Instruction 

Stack Pointer 
Spare 

Switch Register 

Source 

Slave Sync 

Start 

Set Trap Marker 

Strobe 

Subtract 

Service 

System Vector Table 

Swap Byte 

The movement of programs or program sections from 
secondary storage to core. 



TA 

Table 

TE^P 

TK 

TKB 

TKS 

TP 

TPS 

TRT 

TSC 

TST 



Trap Address 
Track Address 

A collection of data in a form suitable for ready reference, 

Temporary 

Teletype Keyboard 

Teletype Keyboard Buffer Register 

Teletype Keyboard Status Register 

Teletype Printer 

Teletype Printer Status Register 

Trace Trap 

Timing State Control 

Test 



UFD 
UIC 



User File Directory. Contains the names and locations of 
all files created under a UIC. (See MFD.) 

User Identification Code. A code which associates a user 
with one of the UFDs on a device. 
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user 



User Program 
UTR 



The person who is using the Monitor. He may use the 
Monitor as an operator, or via a program. 

Any program written by a user to run under the Monitor. 

User Trap 



VEC 



Vector 



WC 
WCR 



Word Count 

Word Count Register 



XDR 

XRCG 

XWCG 



X-line Driver 

X-line Read Control Group 

X-line Write Control Group 



YDR 

YRCG 

YWCG 



Y-line Driver 

Y-line Read Control Group 

Y-iine Write Control Group 
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APPENDIX O 
FILENAME EXTENSIONS 



Extension Attribute 



ALG ALOGL source file 

BAS BASIC source file 

BAK Backup file 

BLI BLISS source file 

CBL COBOL source file 

CIF Core Image File 

CIL Core Image Library 

CMD Command file 

CRF Input to cross-referencing program 

DAT DATA file for FORTRAN job 

DDT Reserved for DDT 

DGN Diagnostic message file 

FTN FORTRAN source file 

FCL FOCAL source list 

LBO Library of object modules (other types of 

libraries may also be implemented) 

LCL Linked core image library 

LDA Load module. Absolute 

LDR Load module, Relocatcible 

LOG Logging file 

LSP LISP source file 

LST Listing file 

MAC MACRO assembler source file 

MAP MAP file 

MFD Master file directory 

OBJ Object module 

OPR Program generation information 

OVR Overlay 

PAL PAL assembler source file 

PLl PL/1 source file 

RNO Reserved for RUNOFF program 

ROL Reserved for ROLLIN program 

RPG RPG source file 

SNO SNOBOL source file 

SPC SPEC format text 

STB Symbol Table (Link— 11 output) 

SYM File of symbols 

SYS System management 

TMP Temporary scratch file 

UFD User File Directory 



0-1 



INDEX 



Abbreviations, N-1 
Access, 

direct, 3-33 

random, 3-31 
.ALLOC request, 3-39 
.APPND request, 3-43 
ASCII to binary conversion, 

3-71, 3-73 
ASCII mode transfer, 3-88 
ASR-33 Teletype, H-1 
Assembler directive, 

.GLOBL, 3-18 

.GLOBL OPN, C-1 

.MCALL, 3-1 
ASSIGN command, 2-13, 2-14 
Assignment, device, 2-13, 3-17 
Automatic deletion, 3-46 



BEGIN command, 2-15, 2-16, 2-17 

after crash, 2-16 
.BIN2D request, 3-72 
Binary to ASCII conversion, 3-72, 

3-74 
Binary mode transfer, 3-88 
,BIN20 request, 3-73 
BLKBLK (BLOCK block) , 3-94 
BLOCK level I/O, 1-2 
.BLOCK request, 3-31, 3-33 
Block, 

contiguous, 1-9 

file, 3-47, 3-101 

linked, 1-9, 3-8, 3-47, 3-101 

run, 3-47 
Buffer area, 1-4 
Buffer, 

keyboard, 2-9 

line, 3-6 
BUFHDR (Line Buffer Header) , 3-87 



Card punch character codes, M-1 
Changing protection code, 3-42 
Character codes, 

ASCII, M-2 

punch card, M-1 
Character deletion, 2-7 
Characters , 

special keyboard, 2-7, 2-8 

teleprinter input, 2-2 
CIL (Core Image Library), 3-6 3 
.CLOSE request, 3-26 
Command conventions, 2-12 
Commands , 

allocate system resources, 
2-11 

exchange information with sys- 
tem, 2-11 



keyboard, 1-2, 2-10, 2-11, 3-11, 

3-51 
legal, 2-3 

manipulate core images, 2-11 
miscellaneous, 2-11 
start program, 2-11 
stop program, 2-11 
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ASSIGN, 2-13, 2-14 

BEGIN, 2-14 through 2-17 
after program crash, 2-16 

CONTINUE, 2-18 

DATE, 2-19 

DUMP, 2-20 

ECHO, 2-21 

END, 2-22 

FINISH, 2-23 

GET, 2-24 

KILL, 2-25 

LOGIN, 2-10, 2-26 

MODIFY, 2-27 

ODT, 2-29 

PRINT, 2-30 

RESTART, 2-31, 3-51 

RUN, 2-32 

SAVE, 2-34 

STOP, 2-36 

TIME, 2-37 

WAIT, 2-38 
Commands listed by functions, 2-2 
Command String Interpreter (CSI) , 

2-1, 2-5, 3-75 through 3-79, I-l 
interfacing with, 3-75 
Comments, 2-8 

Completion of processing, 3-36 
Contiguous file, 1-9, 3-23, 3-30, 

creation, 3-39 
Contiguous block, 1-9 
CONTINUE command, 2-18 
Controller, device, 1-8 
Conventions, command format, 2-12 
Conversion, 

ASCII to binary, 3-71, 3-73 
binary to ASCII, 3-72, 3-74 

date/time from binary to ASCII, 
3-57 

Radix-50, 3-67 
Conversion table, 

mathematical, L-12 

octal-decimal, L-1 
.CORE request, 3-42 
Core Image Library (CIL), 3-63 
Core map, 1-5 
Core organization, 1-4 
Crash, program/system, 2-16 
CSI (see Command String Interpreter) 
.CSIl request, 3-76 
.CSI2 request, 3-77 
CTRL/C keys, 2-7 
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Current user's UIC request, 3-59 
.CVTDT request, 3-57 



Data mode, 2-4 
Dataset, 1-8 

specifier, 2-12 
DATE command, 2-19 
Date conversion binary to ASCII, 

3-57 
.DATE request, 3-55 
Debugging, 2-29 
DECtape Drive TCll, H-14 
.DELET request, 3-41 
Deletion, 

automatic, 3-46 

of characters, 2-7 

of file, 3-41 

of line, 2-8 
Device, 

assignment, 2-13, 3-17 

controller, 1-8 

directory, 1-9 

driver level, 1-2 

independence, 1-1, 3-8, 3-16 

mnemonics, 2-12, 3-68, A-1 

name request, 3-60 
Devices, 

file-structured, 1-9, 3-30 

non-file structured, 1-9 

peripheral, H-1 
Direct access, 3-33 
Directory, device, 1-9 
.D2BIN request, 3-71 
$ symbol, 2-10 
DUMP command, 2-20 



ECHO command, 2-21 

Echo, keyboard, 2-21 

EMT instructions, 3-18 

EMT codes, summary, B-1 

END command, 2-22 

Equivalence, Radix-50, A-1 

Error conditions, file name block 

3-83 through 3-86 
Error messages, 1-6 

summary, F-1 
Example programs, K-1 
Exception interrupt vector, 3-66 
Execution start, 2-15 
.EXIT request, 3-49 



FILBLK (File Block) , 3-82 
File (definition) , 1-8 

contiguous, 1-9, 3-2 3, 3-3C 
linked, 1-9, 3-23, 3-43 
File block, 3-47, 3-101 
parameter, 3-75 



File, 

deletion, 3-41 

directories, 1-3 

protection, 3-42 

protection codes, 3-86 

structure, 1-9 
Filename Block, 3-82 
Filenames, 2-6, 3-42 

extension, 2-6 

reserved extension, 0-1 

search for specified, 3-44 
File-structured device, 1-9 
FINISH command, 2-2 3 
Floating-point exception vector, 

3-66 
Format conventions for commands, 2-12 
Formatted level I/O, 1-2 
Free core, 1-4 
Functions, 2-2, 2-3 

special I/O, J-1 
Function Word, 3-99 



GET command, 2-24 


Getting on the system, 2-10 


Global 


name restriction, 3-19 


Global 


names 


ALO, 


3-39 


APP, 


3-43 


BLO, 


3-31 


CDT, 


3-57 


CLS, 


3-26 


CSM, 


3-77 


CSX, 


3-76 


CVT, 


3-67, 3-70 through 3-74 


DEL, 


3-41 


DIR, 


3-44 


GUT, 


3-50 through 3-56, 3-59 


through 3-66 


INR, 


3-20 


OPN, 


3-22 


PRO, 


3-46 


REC, 


3-30 


REN, 


3-42 


RLS, 


3-21 


RUN, 


3-47 


RWN, 


3-28, 3-29 


SPC, 


3-37 


STT, 


3-38 


TRA, 


3-33 


XIT, 


3-49 



.GLOBL assembler directive, 3-18 

.GLOBL OPN assembler directive, C-1 

Glossary, N-1 

.GTCIL request, 3-6 3 

.GTPLA request, 3-61 

.GTSTK request, 3-64 

.GTUIC request, 3-59 
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Hardware configurations, 1-6 
Header, Line Buffer, 3-9, 3-87 



.INIT request, 3-20 

Interrupt priority level, 3-18 

Interrupt vectors, 1-4 

I/O functions, special, J-1 

I/O levels, formatted, 1-2 

I/O services , 3-1 

lOT instructions, 3-18 



•KEEP request, 3-46 
Keyboard , 

buffer, 2-9 

character processing, 2-9 

commands, 1-2, 2-11 

echo, 2-21 
KILL command, 2-25 



Legal commands. Monitor, 2-3 

Level of transfer, 3-6 

Levels of I/O, 1-2 

Line, (definition of) , 1-9 

Line Buffer Header, 3-6, 3-9, 3-8/ 

Line deletion, 2-8 

Link Block, 1-9, 3-8, 3-47, 3-80, 

3-101 
parameters, 3-75 
Link pointer, 3-19 
Linked file, 1-9, 3-23, 3-43 
Listing of SYSMAC.SML (system 

macro file) , G-1 
LNKBLK (Link Block) , 3-80 
Load address, 3-100 
Load module/core image, 3-100 
Logical names, 1-1, 2-12 
LOGIN command, 2-10, 2-26 
.LOOK request, 3-44 
LPll Line Printer, H-5 



Magtape Drive, TUlO , H-9 
Master File Directory (MFD) , 1-9 
.MCALL assembler directive, 3-1 
Messages, error, 1-6 

summary, F-1 
MFD (Master File Directory) , 1-9 
Mnemonics , device , 3-6 8 

summary, A-1 
Mode Byte, 3-88 
Modes of operation, 2-4 
Mode of transfer, 3-8, 3-28 
MODIFY command, 2-27 

.MONF request, 3-54 

.MONR request, 3-53 



Monitor, 1-1 

command conventions, 2-12 

commands by function, 2-2 

core organization, 1-4 

messages, 1-6 

mode, 2-4 

parameters, 3-50, 3-52 

requests, summary of, 3-4, 3-5, 

E-1 
restrictions, 3-18 



Names, 

logical, 1-1 

physical device, A-1 
Non-file structured device, 1-9 



.02BIN request, 3-73 
ODT command, 2-29 
.OPN request, 3-22 
.OPENx request, 3-22 through 3-26 
Organization, core, 1-4 
Overlay/Program, 3-101 
Overlays and subsidiary routines, 
C-1 



Paper tape reader/punch, H-3 
Parameters , 

File Block, 3-75 

Link Block, 3-75 

Monitor, 3-50, 3-52 
Peripheral devices, H-1 

Radix-50 representation, 3-68 
Physical device names, A-1 
Pointer, link, 3-19 
PRINT command, 2-30 
Processing, 

completion of, 3-36 

keyboard character, 2-9 
Program crash, 2-16 
Program low address (PLA) , 3-61 
Program status, 2-4 
Program Status Word (PSW) , 3-66 
Programmed requests, 1-2, 3-1, 
3-3, 3-6 

summary, E-1 
Programmer restrictions, 3-18 
PROTECT byte, 3-46 
Protection boundary, 3-61 
Protection code change, 3-42 
PSW (program status word) , 3-66 



Radix-50, 

conversion to packed ASCII, 3-6 7 
equivalence, A-1 
representation for peripheral 

devices, 3-68 
unpacked, 3-70 
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.RADPK request, 3-67 
.RADUP request, 3-70 
Random access, 

to file records, 3-10, 3-31 

to I/O level, 1-2 
.READ request, 3-28 
READ or WRITE level requests, 3-6 
RECBLK (Record Block) , 3-93 
RECORD level I/O, 1-2 
REcord level requests, 3-10 
.RECRD request, 3-30 
.RENAM request, 3-42 
Requests , 

block level, 3-12 

Monitor code for, C-1 

programmed, 1-2, 3-3, 3-6 

READ/WRITE level, 3-6 

RECORD level, 3-10 

summary of, 3-4, 3-5, E-1 

TRAN level, 3-14 
RESET instruction, 3-18 
Restart address, 3-51 
RESTART command, 2-31, 3-51 
Restrictions, 

global name, 3-19 

prograinmer, 3-18 
Return address, 3-100 
.RLSE request, 3-21 
.RSTRT request, 3-51 
RUBOUT, 2-9 
RUN command, 2-32 
.RUN request, 3-47 
RUNBLK (RUN Block) , 3-98 
Run block, 3-47 



SAVE command, 2-34 

Search for a specified filename. 

3-44 
Services, I/O, 3-1 
SPCBLK (Special Function Block) , 

3-97 
.SPEC request, 3-37 
Special Functions Block (SPCBLK) , 

3-97 
Special keyboard characters, 2-7 
Square bracket ([]) usage 

commands, 2-12 
Stack, 1-4 

base, 3-64, 3-65 
movement, 3-100 
storage areas, 3-18 
Start execution, 2-15 
Starting Monitor, 1-7 
.STAT request, 3-38 
Status Byte, 3-91 
.STFPU request, 3-66 
STOP command, 2-8, 2-36 
Storage areas on the stack, 3-18 
.STPLA request, 3-62 
.STSTK request, 3-65 
Subsidiary routines and overlays, 

C-1 



Summary, 

of EMT codes, B-1 

Monitor commands, D-1 

Monitor requests, 3-4 
Swapping routines into core, 3-17 
.SYSDV request, 3-60 
System, see specific subject 
SYSMAC.SML (system macro file), 
3-1 



Table standards, 1-9 

TCll DECtape Drive, H-14 

Teleprinter input characters, 2-2 

Teletype, ASR-33, H-1 

Terminology, 1-8 

.TIME request, 3-56 

TIME command, 2-37 

Time conversion, binary to ASCII, 

3-57 
.TRAN request, 3-33 
TRAN Block (TRNBLK) , 3-95 
TRAN level requests, 3-14 
Transfer Address offset, 3-100 
Transfer levels, 1-2, 3-6 
Transfer modes, 3-28, 3-88 

ASCII/binary, 3-8 
.TRAP request, 3-50 
TRNBLK (TRAN Block) , 3-95 
TUlO Magtape Drive, H-9 



User area, 1-4 

User File Directory (UFD) , 1-9 

User Identification Code (UIC) , 2-5 

current user UIC request, 3-59 
User Mode, 2-4 



Vector, floating-point exception, 
3-66 



WAIT command, 2-38 
.WAIT request, 3-35 
.WAITR request, 3-36 
.WRITE request, 3-29 
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HuW TO OBTAiN SOFTWARE iNFORMATiON 

Announcements for new and revised software, as well as programming notes, 
software problems, and documentation corrections are published by Software 
Information Service in the following newsletters. 

Digital Software News for the PDP-8 & PDP-12 

Digital Software News for the PDP-11 

Digital Software News for the PDP-9/i5 Family 

These newsletters contain information applicable to software available from 
Digital's Program Library, Articles in Digital Software News update the 
cumulative Software Performance Summary which is contained in each basic 
kit of system software for new computers. To assure that the monthly Digital 
Software News is sent to the appropriate software contact at your installation, 
please check with the Software Specialist or Sales Engineer at your nearest 
Digital office. 

Questions or problems concerning Digital's Software should be reported to 
the Software Specialist. In cases where no Software Specialist is available, 
please send a Software Performance Report form with details of the problem to: 

Software Information Service 
Digital Equipment Corporation 
146 Main Street, Bidg. 3-5 
Maynard, Massachusetts 01754 

These forms which are provided in the software kit should be fully filled out 
and accompanied by teletype output as well as listings or tapes of the user 
program to facilitate a complete investigation. An answer will be sent to the 
individual and appropriate topics of general interest will be printed in the 
newsletter. 

Orders for new and revised software and manuals, additional Software Per- 
formance Report forms, and software price lists should be directed to the 
nearest Digital Field office or representative. U.S.A. customers may order 
directly from the Proc)'"flm Library in Maynard. When ordering, include the 
code number and a brief description of the software requested. 

Digital Equipment Computer Users Society (DECUS) maintains a user lib-ary 
and publishes a catalog of programs as well as the DECUSCOPE magazine 
for its members and non-members who request it. For further information 
please write to: 

DECUS 

Digital Equipment Corporation 
146 Main Street, Bidg. 3-4 
Maynard, Massachusetts 01754 
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READER'S COMMENTS 



Digital Equipment Corporation maintains a continuous effort to Improve the quality and usefulness 
of Its publications. To do this effectively we need user feedback — your critical evaluation of 
this manual. 

Please comment on this manual's completeness, accuracy, organization, usability and read- 
ability. 



Did you find errors in this manual? If so, specify by page. 



How can this manual be improved? 



Other comments? 



Please state your position. Date: 

Name: Organization: 



Street: Department: 



City: State: Zip or Country 
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